Create transaction

This endpoint is used to initiate a money transfer transaction through Balad’s Collection API.
It supports multiple transaction types (Cash, Card, Bank Account and Wallet) and requires sender, receiver, and transaction details to be passed in the request body.

Sender Details

Parameter	Remarks
sender_first_name	First or full legal name. Must match valid ID. Could be sender first name only or sender full name (Full Name must be the full legal name of the sender and must exactly match the name as it appears on the sender's valid ID.)
sender_middle_name	Middle name. Same character rules as first name.
sender_last_name	Last name. Same character rules as first name.
sender_address	Full sender address.
sender_dateofbirth	Format: `DD-MMM-YYYY`. Example: `01-JUN-2020`.
sender_contact_no	Contact number.
sender_identity	Identity type: 1 = Passport, 2 = Government-issued ID.
sender_identity_no	ID/Passport number. Allowed: periods (.), commas (,), underscores (_), hyphens (-), space ( ).
sender_identity_expiry_date	ID Expiry Date. Format: `DD-MMM-YYYY`. Must not be expired.
sender_nationality	ISO alpha-2 country code (e.g., `US`, `EG`).
sender_country_code	ISO alpha-2 country code of residence.
sender_country_of_birth	Country of birth, valid country string (e.g., `Egypt`, `United States of America`).
sender_gender	1 = Male, 2 = Female.

Receiver Details

Transaction Details

Required Fields

Field	Cash Pickup (`1`)	Bank Account (`2`)	Wallet (`3`)
transaction_type	✅	✅	✅
remitter_reference_no	✅	✅	✅
sender_first_name	✅	✅	✅
sender_last_name	✅	✅	❌
sender_address	✅	✅	✅
sender_dateofbirth	✅	✅	✅
sender_contact_no	❌	❌	❌
sender_identity (type)	❌	❌	❌
sender_identity_no	❌	❌	❌
sender_identity_expiry_date	❌	❌	❌
sender_nationality	✅	✅	✅
sender_country_code	✅	✅	✅
receiver_first_name	✅	✅	✅
receiver_last_name	❌	❌	❌
receiver_address	❌	✅	❌
receiver_contact_no	✅	❌	✅
receiver_identity_type	❌	❌	❌
receiver_identity_no	❌	❌	❌
receiver_gender	❌	❌	❌
receiver_relationship	❌	❌	❌
account_no	❌	✅	✅
receiver_bank_code	✅	✅	❌
sending_currency_code	✅	✅	✅
amount	✅	✅	✅
source_of_remittance	❌	❌	❌
purpose	✅	✅	✅
value_date	❌	❌	❌
business_model_type	❌	❌	❌

Bearer Token

Provide your bearer token in the

Authorization

header when making requests to protected resources.

Example:

Authorization: Bearer ********************

application/json

Bodyapplication/json

{
    "data": {
        "remitter_reference_no": "XXXXXXXXXXXXXXXXXXX",
        "delivery_estimate": "XXXXXXXXXXXXXXXXXXX"
    },
    "errors": null
}

Create transaction

Required Fields

Request

Request Code Samples

Responses

Create transaction

Required Fields#

Request

Request Code Samples

Responses

Required Fields