Pay-in collection

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

Amount range

bKash pay-in supports 50-30,000 BDT per transaction where enabled for your merchant account.

Request

POST/v2.0/transaction/pay-in

Request Path:

sandbox: https://sandbox-gateway.smilepayz.com/v2.0/transaction/pay-in
production: https://gateway.smilepayz.com/v2.0/transaction/pay-in

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.
payer.name	O	String	Payer name.
payer.phone	O	String	Payer mobile number.
redirectUrl	O	String(256)	Post-pay return URL.
callbackUrl	O	String(256)	Async status URL.

Example Body

{
    "orderNo": "BDT_PAYIN_10001",
    "purpose": "Bangladesh bKash pay-in",
    "merchant": {
        "merchantId": "20001"
    },
    "money": {
        "currency": "BDT",
        "amount": 1000
    },
    "paymentMethod": "BKASH",
    "payer": {
        "name": "Rahim Uddin",
        "phone": "01712345678"
    },
    "redirectUrl": "https://www.example.com/success",
    "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.paymentUrl	O	String	Hosted payment URL when returned.
status	O	String	INIT, PROCESSING, SUCCESS, FAILED, or EXPIRED.

Notification/Callback

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