Documentation
Beneficiaries
Guinea Beneficiary

Guinea Beneficiary

Payouts to Guinea are made via mobile money (MTN, ORANGE, or BnB CashApp).

Below is a sample request for creating a Guinean beneficiary:

cURL
curl --location '{{sandboxURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "ray.jon@mail.com",
    "country": "GN",
    "currency": "GNF",
    "destination": {
        "network": "MTN",
        "type": "MOBILEMONEY",
        "accountNumber": "224687654253",
        "accountName": "Jon Snow",
        "sender": {
            "accountName": "John Snow",
            "country": "NG"
        }
    }
}'
ParameterDescriptionRequired
typeThis is the payment type. It will be MOBILEMONEY
accountNumberThis is the phone number of the beneficiary
accountNameThis is the name of the beneficiary
networkThe phone number's mobile network. Must be MTN, ORANGE or BnB CashApp.

Sender Parameters

ParameterDescriptionRequired
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]Sender's country