This page contains information about configuring the Airtel FSP integration in a 121 Platform Instance.

Add the IP address from which you want to send requests in the Airtel Dashboard

For the Airtel FSP integration to work for any program, some settings need to be configured via environment variables:

AIRTEL_API_URL

The value is the base URL of Airtel's API. Both the staging and production URLs can be found in the Airtel documentation.

AIRTEL_CLIENT_ID

This value can be found in the Airtel dashboard.

AIRTEL_CLIENT_SECRET

This value can be found in the Airtel dashboard.

AIRTEL_DISBURSEMENT_PIN

Disbursement calls (including enquiry calls) need to have an encrypted PIN sent along. This PIN can be configured in the Airtel dashboard. The PIN is used for all encryption versions, so no version is needed.

AIRTEL_DISBURSEMENT_V1_PIN_ENCRYPTION_PUBLIC_KEY

This value is a 1024-bit RSA public key and can be found in the Airtel documentation. Double check that you're using the public key for the correct version.

The PIN is non-versioned, this public key is versioned.

AIRTEL_ENABLED

Set this to true to enable Airtel for a specific instance.

121 uses the disbursement flow of Airtel, where money is transferred from a sender mobile wallet to the recipients mobile wallet.

Airtel can work in different countries, the current integration in the 121 platform is hardcoded to Zambia and the Zambian currency.

When a payment is made to a registration with Airtel FSP, money is transferred to the mobile wallet of the recipient.

When a disbursement fails a failed transaction will be created and the end user can retry the transaction.

When the Airtel API doesn't respond or doesn't respond correctly a failed transaction will be created.

When the 121 Platform has a malfunction during a disbursement the next time the payment is tried and Airtel knows about this disbursement it will send a duplicate error, the 121 Platform then retrieves the status for the disbursement and proceeds accordingly.

For more information about Airtel's API see the Airtel documentation.