Skip to main content
POST
BDT Collection Application

Secret Key & Private Key (Generate Signature)

Body

application/json
appId
integer
required

Business ID (obtained from backend, must pass the corresponding business ID according to the currency in the URL)

orderId
string
required

Merchant order number (must be unique, maximum length 48)

Maximum string length: 48
name
string
required

User’s full name, recommended to use real name. Format: include firstName and lastName, separated by a space. Example: John Doe

phone
string
required

Valid phone number

email
string<email>
required

Valid email

amount
string
required

Transaction amount (integers only, decimal places are not supported; punctuation marks such as "," are prohibited)

Pattern: ^\d+$
payType
string
required

Transaction type

inBankCode
string
required

Payment Method

callBackUrl
string<uri>
required

Redirect URL after successful payment

callBackFailUrl
string<uri>
required

Redirect URL after failed payment

subject
string
required

Payment remark

partnerUserId
string
required

Unique user identifier (e.g., userId). Must be valid, otherwise it will affect the transaction. Format: digits, letters, or symbols -~!@#$%&*()_.

Pattern: ^[A-Za-z0-9\-~!@#$%&*()_]+$
sign
string
required

Signature

notifyUrl
string<uri>

Callback URL

body
string

Remark details

Response

200 - application/json
status
string

1: Normal, 0: Exception

error
string

Error code

msg
string

Error description

data
object

返回数据

Last modified on July 16, 2026