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:
| 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 BH | ✅ |
| 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.