Documentation
Beneficiaries
Bahrain Beneficiary

Bahrain Beneficiary

Before making a payment to a Bahrain bank account, you must add the account as a beneficiary. Note that payments to Bahrain beneficiaries are via SWIFT.

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

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": "BH",
    "currency": "USD",
    "destination": {
        "type": "SWIFT",
        "accountName": "Khalid Al Khalifa",
        "accountNumber": "BH67BMAG00001299123456",
        "swiftCode": "BMAGBHBM",
        "bankName": "Bank of Bahrain and Kuwait",
        "bankAddress": "43 Government Avenue",
        "bankCity": "Manama",
        "bankPostCode": "305",
        "bankCountry": "BH",
        "remittancePurpose": "FAMILY_SUPPORT",
        "beneficiary": {
            "type": "INDIVIDUAL",
            "country": "BH",
            "city": "Manama",
            "state": "Capital",
            "postCode": "305",
            "address": "12 Al Fateh Highway",
            "phoneNumber": "+97317123456",
            "nationality": "BH",
            "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 Bahrain SWIFT beneficiaries are:

ParameterDescriptionRequired
typeThis is the payment type. It must be SWIFT✅
accountNameName on the receiving bank account✅
accountNumberAccount number or IBAN of the receiving account✅
swiftCodeSWIFT/BIC of the receiving bank (8 or 11 characters)✅
bankNameName of the receiving bank✅
bankAddressStreet address of the receiving bank✅
bankCityCity of the receiving bank✅
bankPostCodePost code of the receiving bank✅
bankCountryCountry of the receiving bank. Must be BH✅
remittancePurposePurpose of the transfer. See the SWIFT guide for accepted values✅
beneficiaryAccount holder details. See the SWIFT guide✅
senderSender 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.