Rwanda Beneficiary
Payouts to Rwanda are made via mobile money (MTN, AIRTEL).
Below is a sample request for creating a Rwandan beneficiary:
cURL
curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
"reference": "<samplereference>",
"customerEmail": "ray.jon@mail.com",
"country": "RW",
"currency": "RWF",
"callbackUrl": "https://webhook.site/38a9e6b0-3388-4399-89d4-3ceafa000001",
"destination": {
"type": "MOBILEMONEY",
"accountName": "Toronto Tech Solutions Inc",
"accountNumber": "250789456123",
"network": "MTN",
"sender": {
"accountName": "John Snow",
"country": "NG",
"address": "053 Rodriguez Lodge"
}
}
}'| Parameter | Description | Required |
|---|---|---|
| type | This is the payment type. It will be MOBILEMONEY | ✅ |
| accountName | This is the name of the beneficiary | ✅ |
| accountNumber | This is the phone number of the beneficiary | ✅ |
| network | The phone number's mobile network, in this case, MTN or AIRTEL | ✅ |
| sender | Sender information. Expanded based on sender[type]. | ✅ |
Sender Parameters
| Parameter | Description | Required |
|---|---|---|
| sender[accountName] | Name of the sender. A space separated first and last name must be provided for individual senders e.g John Doe | ✅ |
| sender[country, address] | Sender's address details | ✅ |