Airtel Money - SandPay

Airtel Money — Open API merchant payments.

Covered countries

Country	Code	Currency
Rwanda	RW	RWF

Additional Airtel markets (Uganda, Tanzania, DRC…) will be added post-launch.

Type	URL
Dev portal	developers.airtel.africa
Sandbox UAT	`https://openapiuat.airtel.africa`
OAuth token	`https://openapiuat.airtel.africa/auth/oauth2/token`
Payment	`https://openapiuat.airtel.africa/merchant/v1/payments/`
USSD client	`*185#`

Enter these in Settings → Stores → Airtel:

Field	Type	Description
`client_id`	text	OAuth `client_id` for your Airtel Developer app.
`client_secret`	password	Associated OAuth secret.

OAuth client_credentials with JSON body: unlike Orange (which expects x-www-form-urlencoded), Airtel requires a JSON body { "client_id": ..., "client_secret": ..., "grant_type": "client_credentials" } on the token endpoint. SandPay handles this variant via oauthClientCredentialsJsonBody.
The X-Country and X-Currency headers are required on the POST /merchant/v1/payments/ call — they are derived from the MSISDN or explicitly passed via the country field.
msisdn is sent without the + in the subscriber object.
The Airtel payload separates subscriber (the payer) and transaction (the movement) — SandPay copies reference into both id fields to remain idempotent.
Nested response: data.transaction.id — this value is stored as provider_tx_id.