Disbursement (pay-out)

Bangladesh region pay-out API (BDT). See Payment methods.

Amount range

Bangladesh pay-out supports 50-50,000 BDT per transaction where enabled for your merchant account.

Request

POST/v2.0/disbursement/pay-out

Request Path:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/disbursement/pay-out
production: https://gateway.smilepayz.com/v2.0/disbursement/pay-out

Header Parameters

Field	Required	Type	Description
Content-Type	M	String	application/json request body.
X-TIMESTAMP	M	String	Format: yyyy-MM-ddTHH:mm:ss±HH:mm (Bangladesh +06:00).
X-SIGNATURE	M	String	Signature of JSON body (see product Signature doc).
X-PARTNER-ID	M	String	Your merchantID.

Body Parameters

Field	Required	Type	Description
orderNo	M	String(32)	Merchant-unique id.
purpose	M	String(64)	Transaction memo.
merchant.merchantId	M	String	Smilepayz merchantId.
money.currency	M	String	Fixed to BDT.
money.amount	M	Number	Amount in BDT.
paymentMethod	M	String	BKASH or NAGAD.
cashAccount	M	String(32)	Beneficiary wallet number.
receiver.name	M	String	Beneficiary full name.
receiver.phone	M	String	Beneficiary wallet mobile number.
callbackUrl	O	String(256)	Async status URL.

Example Body

{
    "orderNo": "BDT_PAYOUT_10001",
    "purpose": "Bangladesh wallet pay-out",
    "merchant": {
        "merchantId": "20001"
    },
    "money": {
        "currency": "BDT",
        "amount": 1000
    },
    "paymentMethod": "BKASH",
    "cashAccount": "01712345678",
    "receiver": {
        "name": "Rahim Uddin",
        "phone": "01712345678"
    },
    "callbackUrl": "https://www.example.com/callback"
}

Response

Field	Required	Type	Description
code	M	String	00 success, other values error.
message	M	String	Result message.
orderNo	M	String	Merchant order number.
tradeNo	O	String	Smilepayz trade number.
money.currency	M	String	BDT.
money.amount	M	Number	Order amount.
channel.paymentMethod	M	String	Pay-out method.
channel.cashAccount	M	String	Beneficiary wallet number.
status	O	String	INIT, PROCESSING, SUCCESS, FAILED, or EXPIRED.

Notification/Callback

Respond with the string SUCCESS only after the callback is accepted.