Disbursement
Send mobile money payments to your customers with Nkwa Pay’s disbursement API, supporting both MTN and Orange mobile networks in Cameroon.
Mobile Money Disbursement
How it Works
Nkwa Pay allows you to send funds directly to your customers’ mobile money wallets. Unlike payment collections, disbursements do not require the customer to authorize the transaction with a PIN code - they simply receive the funds in their mobile money account.
The disbursement flow works as follows:
- Initiate Disbursement: Your application sends a disbursement request to Nkwa Pay API
- Balance Check: Nkwa Pay verifies you have sufficient balance in your account
- Processing: The mobile network operator (MTN or Orange) processes the disbursement
- Notification: Nkwa Pay notifies your application about the disbursement outcome via webhook
- Customer Receipt: The customer receives the funds in their mobile money account along with an SMS notification
Disbursements are useful for various business scenarios including:
- Refunds for returned products or canceled services
- Payouts to freelancers or gig workers
- Loan disbursements by financial institutions
- Prize or promotion payments
- Salary payments to employees or contractors
Disbursement Status
Once your disbursement request has been accepted for processing, it will have one of the following statuses on the Nkwa Pay platform:
| Status | Description |
|---|---|
| PENDING | The disbursement request has been accepted and is being processed by the MNO |
| SUCCESSFUL | The disbursement has completed successfully and funds have been received by the customer. This is a final state. |
| FAILED | The disbursement request has failed. Common causes include invalid phone numbers, MNO service issues, or account restrictions. This is a final state. |
Implementation Recommendations
- Balance Management: Ensure your Nkwa Pay account has sufficient balance before initiating disbursements
- Recipient Verification: Validate phone numbers before initiating disbursements to reduce failures
- Transaction Records: Maintain detailed records of all disbursements for reconciliation
- Status Updates: Implement webhook handlers to receive real-time disbursement status updates
- Notification: Consider sending your own notifications to customers informing them about the disbursement
- Phone Number Format: Ensure phone numbers are properly formatted with the country code (e.g., “237600000000”)
Testing Disbursements
In the sandbox environment:
- For MTN, use the test numbers provided in the MTN MoMo developer documentation
- For Orange, use a real phone number to properly test the disbursement flow
Refund Policy
If a disbursement request fails, you will be refunded the full amount of the disbursement (amount + fees) to your Nkwa Pay account balance. No funds are lost for failed disbursements.
See our Implementation Guide for more details on integrating disbursements into your application.
Disbursement
Send mobile money payments to your customers with Nkwa Pay’s disbursement API, supporting both MTN and Orange mobile networks in Cameroon.
Mobile Money Disbursement
How it Works
Nkwa Pay allows you to send funds directly to your customers’ mobile money wallets. Unlike payment collections, disbursements do not require the customer to authorize the transaction with a PIN code - they simply receive the funds in their mobile money account.
The disbursement flow works as follows:
- Initiate Disbursement: Your application sends a disbursement request to Nkwa Pay API
- Balance Check: Nkwa Pay verifies you have sufficient balance in your account
- Processing: The mobile network operator (MTN or Orange) processes the disbursement
- Notification: Nkwa Pay notifies your application about the disbursement outcome via webhook
- Customer Receipt: The customer receives the funds in their mobile money account along with an SMS notification
Disbursements are useful for various business scenarios including:
- Refunds for returned products or canceled services
- Payouts to freelancers or gig workers
- Loan disbursements by financial institutions
- Prize or promotion payments
- Salary payments to employees or contractors
Disbursement Status
Once your disbursement request has been accepted for processing, it will have one of the following statuses on the Nkwa Pay platform:
| Status | Description |
|---|---|
| PENDING | The disbursement request has been accepted and is being processed by the MNO |
| SUCCESSFUL | The disbursement has completed successfully and funds have been received by the customer. This is a final state. |
| FAILED | The disbursement request has failed. Common causes include invalid phone numbers, MNO service issues, or account restrictions. This is a final state. |
Implementation Recommendations
- Balance Management: Ensure your Nkwa Pay account has sufficient balance before initiating disbursements
- Recipient Verification: Validate phone numbers before initiating disbursements to reduce failures
- Transaction Records: Maintain detailed records of all disbursements for reconciliation
- Status Updates: Implement webhook handlers to receive real-time disbursement status updates
- Notification: Consider sending your own notifications to customers informing them about the disbursement
- Phone Number Format: Ensure phone numbers are properly formatted with the country code (e.g., “237600000000”)
Testing Disbursements
In the sandbox environment:
- For MTN, use the test numbers provided in the MTN MoMo developer documentation
- For Orange, use a real phone number to properly test the disbursement flow
Refund Policy
If a disbursement request fails, you will be refunded the full amount of the disbursement (amount + fees) to your Nkwa Pay account balance. No funds are lost for failed disbursements.
See our Implementation Guide for more details on integrating disbursements into your application.