Airtel Rwanda Money API

CK SOFTWARE · UAT integration and diagnostics

UAT environment only. Use an Airtel-approved test wallet. Never display API secrets, access tokens, PINs, or raw encryption headers in the browser. A successful HTTP status does not necessarily mean a successful payment.

1. Test OAuth and RSA key

Retrieves an OAuth token, fetches the RSA public key, and validates that PHP can parse the key. This test does not initiate a payment.

2. Collection / Cash-In

Sends a collection request to the configured Airtel UAT endpoint.

Current endpoint
/merchant/v1/payments/
Country / currency
RW / RWF
Enter digits only, without the country calling code. Use a new reference for each new test.

3. Disbursement / Cash-Out (v3)

Sends funds to the payee wallet using Airtel's documented v2 endpoint. Use only an Airtel-approved UAT test wallet.

Endpoint
/standard/v3/disbursements
Digits only, without the country calling code. Do not guess this value. Use the exact enum/value specified in your Airtel Rwanda v3 documentation. The PIN is encrypted server-side and must never be logged or displayed.

4. Configuration diagnostics

These are non-secret settings loaded by Laravel.

Environment
UAT
Base URL
https://openapiuat.airtel.co.rw
Country
RW
Currency
RWF
Collection endpoint
/merchant/v1/payments/
Transactions enabled
Yes
Message signing enabled
Yes
Configured RSA padding
pkcs1
HTTP timeout
30 seconds
Important

The configured RSA padding is not yet independently verified against Airtel's message-signing requirement. Displaying this setting does not mean Airtel has accepted it.

Known connection results

  • OAuth token endpoint: previously HTTP 200.
  • RSA key endpoint: previously HTTP 200.
  • Public key parsing: previously successful, 2048 bits.
  • Collection: requires a successful provider API response.
The connection results above are historical observations, not a live health check. Press the connection-test button to perform a new check.

5. How to diagnose a failed request

  1. HTTP 400 with ROUTER007: inspect API version and router access.
  2. Disbursement: use the v2 endpoint shown above and confirm PIN encryption and message-signing settings with Airtel.
  3. HTTP 200 with success false: inspect the provider's response code and result code.
  4. OAuth failure: inspect token endpoint status without exposing credentials.
  5. RSA validation failure: inspect the safe parsing error in Laravel logs.
  6. Unclear provider error: correlate the request ID with the server log.

Detailed server diagnostics are stored in storage/logs/laravel.log. Never show access tokens, client secrets, PINs, raw request signatures, or full encryption keys in this page.

CK SOFTWARE · Airtel Rwanda UAT diagnostic console. Keep this page behind authentication and do not expose it publicly.