Niger Beneficiary

Payouts to Niger are made via mobile money (MOOV or AIRTEL).

Below is a sample request for creating a Nigerien beneficiary:

cURL

curl --location '{{baseURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "ray.jon@mail.com",
    "country": "NE",
    "currency": "XOF",
    "destination": {
        "network": "MOOV",
        "type": "MOBILEMONEY",
        "accountNumber": "22742435678",
        "accountName": "Jon Snow",
        "sender": {
            "accountName": "John Snow",
            "country": "NG"
        }
    }
}'

Parameter	Description	Required
type	This is the payment type. It will be `MOBILEMONEY`	✅
accountNumber	This is the phone number of the beneficiary	✅
accountName	This is the name of the beneficiary	✅
network	The phone number's mobile network. Must be one of: `MOOV`, or `AIRTEL`	✅

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

USD payouts via SWIFT

Below is a sample request for creating a SWIFT beneficiary in Niger:

cURL

curl --location '{{baseURL}}/beneficiaries' \
--header 'Content-Type: application/json' \
--header 'Authorization: Bearer {{APIKEY}}' \
--data '{
    "reference": "<samplereference>",
    "customerEmail": "ray.jon@mail.com",
    "callbackUrl": "https://webhook.site/38a9e6b0-3388-4399-89d4-3ceafa000001",
    "country": "NE",
    "currency": "USD",
    "destination": {
        "type": "SWIFT",
        "accountName": "Amadou Issoufou",
        "accountNumber": "1234567890",
        "swiftCode": "BIANNENI",
        "bankName": "Banque Internationale pour l'Afrique au Niger",
        "bankAddress": "Rue de Gaweye",
        "bankCity": "Niamey",
        "bankPostCode": "8000",
        "bankCountry": "NE",
        "remittancePurpose": "FAMILY_SUPPORT",
        "beneficiary": {
            "type": "INDIVIDUAL",
            "country": "NE",
            "city": "Niamey",
            "state": "Niamey",
            "postCode": "8000",
            "address": "Avenue de la Liberte",
            "phoneNumber": "+15551234567",
            "nationality": "NE",
            "idType": "PASSPORT",
            "idNumber": "P1234567",
            "idExpiration": "2030-01-15",
            "gender": "MALE",
            "dateOfBirth": "1990-05-20"
        },
        "sender": {
            "type": "INDIVIDUAL",
            "accountName": "Jane Doe",
            "country": "US",
            "city": "New York",
            "state": "NY",
            "address": "123 Main St",
            "postCode": "10001",
            "phoneNumber": "+12125550123",
            "email": "jane.doe@example.com",
            "gender": "FEMALE",
            "idType": "PASSPORT",
            "idNumber": "US1234567",
            "idIssueDate": "2020-06-01",
            "dateOfBirth": "1990-01-15",
            "countryOfBirth": "US",
            "complianceDocument": {
                "proofOfIdentity": "<document-reference>"
            }
        }
    }
}'

The parameters for adding Niger SWIFT beneficiaries are:

Parameter	Description	Required
type	This is the payment type. It must be `SWIFT`	✅
accountName	Name on the receiving bank account	✅
accountNumber	Account number or IBAN of the receiving account	✅
swiftCode	SWIFT/BIC of the receiving bank (8 or 11 characters)	✅
bankName	Name of the receiving bank	✅
bankAddress	Street address of the receiving bank	✅
bankCity	City of the receiving bank	✅
bankPostCode	Post code of the receiving bank	✅
bankCountry	Country of the receiving bank. Must be `NE`	✅
remittancePurpose	Purpose of the transfer. See the SWIFT guide for accepted values	✅
beneficiary	Account holder details. See the SWIFT guide	✅
sender	Sender details including `complianceDocument`. See the SWIFT guide	✅

📘

The beneficiary and sender objects, the sender complianceDocument, the optional bankState and intermediaryBank fields and every accepted enumeration value are documented in the SWIFT Beneficiary guide.

New Zealand Beneficiary Nigeria Beneficiary