Create PayIn

Create payment order

post

Creates a cryptocurrency payment order via Binance or other supported channels, supporting major tokens like USDT.

Workflow:

1. Merchant system calls this API to create an order

2. User completes payment using the returned payment methods

3. System notifies merchant of payment result asynchronously (via callbackUrl)

Header parameters

BiuLinkPay-AppIdstringRequired

BiuLinkPay-TimeStampstringRequired

BiuLinkPay-NoncestringRequired

BiuLinkPay-SignaturestringRequired

Body

application/json

tradeNostringRequired

Unique transaction identifier

Example: 7788991111711117111

userMarkstringRequired

User identifier/email

Example: [email protected]

payTypestring · enumRequired

Payment method/provider

Example: BINANCEPossible values:

orderAmountnumber · floatRequired

Order amount

Example: 1

orderTokenstringRequired

Cryptocurrency token for payment

Example: USDT

orderNetworkstringOptional

Blockchain network for transaction

Example: BSC

settlementAddressstringOptional

Recipient address

Example: 123

currencyTypestring · enumRequired

Type of currency

Example: CRYPTOPossible values:

fiatUnitstringOptional

Fiat currency unit for reference

Example: VND

expiredTimeintegerOptional

Expiration time in milliseconds,default 950

Example: 10000

redirectUrlstring · uriOptional

URL for redirection after payment

Example: https://redirectUrl

callbackUrlstring · uriOptional

URL for payment confirmation callback

Example: https://callbackUrl

refundCallbackUrlstring · uriOptional

URL for refund processing callback

Example: https://refundCallbackUrl

feenumber · floatOptional

Transaction fee (fee not's empty,feeRatio is invalid)

Example: 0.1

feeRationumber · floatOptional

Fee ratio (value is percentage, if feeRatio & fee is null,get merchant config)

Example: 0.01

deductionMethodstring · enumOptional

Fee deduction method

Example: OUTER_BUCKLEPossible values:

Responses

200

Successful operation

application/json

post

/pay/merchant/buyOrder

HTTPcURLJavaScriptPython

POST /api/pay/merchant/buyOrder HTTP/1.1
BiuLinkPay-AppId: text
BiuLinkPay-TimeStamp: text
BiuLinkPay-Nonce: text
BiuLinkPay-Signature: text
Content-Type: application/json
Accept: */*
Content-Length: 401

{
  "tradeNo": "7788991111711117111",
  "userMark": "[email protected]",
  "payType": "BINANCE",
  "orderAmount": 1,
  "orderToken": "USDT",
  "orderNetwork": "BSC",
  "settlementAddress": "123",
  "currencyType": "CRYPTO",
  "fiatUnit": "VND",
  "expiredTime": 10000,
  "redirectUrl": "https://redirectUrl",
  "callbackUrl": "https://callbackUrl",
  "refundCallbackUrl": "https://refundCallbackUrl",
  "fee": 0.1,
  "feeRatio": 0.01,
  "deductionMethod": "OUTER_BUCKLE"
}

200

Successful operation

{
  "code": "0",
  "msg": "SUCCESS",
  "model": {
    "webUrl": "https://pay.binance.com/en/checkout/af805e7ea1dc4d56b25f9c2b506b4312",
    "channelNum": "359132862733934592",
    "orderNum": "100117450710697059977",
    "payCurrency": "USDT",
    "network": null,
    "payAmount": 1.1,
    "expireTime": 1745074671414,
    "qrContent": "https://app.binance.com/qr/dplk7916580f50ee4b49b1bcf4b35c15fabc",
    "qrcodeLink": "https://public.bnbstatic.com/static/payment/20250419/c5963149-6bef-4cb5-8d1b-367593d2be77.jpg",
    "deeplink": "bnc://app.binance.com/payment/secpay?tempToken=9vfPh4BtcaORnZbP10kLYob7I3e3NNJJ&returnLink=https://redirectUrl&cancelLink=https://redirectUrl",
    "address": null
  },
  "success": true,
  "error": false
}