Skip to content

Create pay-in order (own checkout) ​

For merchants with their own payment page. The platform returns the receiving accounts assigned to the order, and you show them to the customer. Then:

When the money arrives you get the usual callback.

POST/api/open/order/createBuyOrder2

Full URL = your API base URL + this path. The base URL is shown in the merchant console under Developers → API & callbacks.

Request parameters ​

Same as Create pay-in order (hosted checkout) (redirectUrl and hideUsdt are not used).

Response ​

FieldTypeDescription
order.orderNostringPlatform order number
order.merchantOrderNostringYour order number
order.totalAmountnumberFiat amount
order.usdtnumberUSDT amount (before fees)
order.currencystringCurrency code
order.orderTimestringOrder time
cards[]arrayReceiving accounts for this order; the customer pays to one of them
cards[].cardIdintAccount ID, needed for Mark as paid
cards[].paymentTypeintPayment method code
cards[].realNamestringAccount holder name
cards[].bankNamestringBank name
cards[].bankBranchstringBank branch
cards[].cardNostringBank card / account number
cards[].payAccountstringPayee account: Alipay / WeChat account, or e-wallet account (MoMo, TrueMoney, PIX, …; card number is empty for these)
cards[].payQrCodestringQR code image or payment link (some methods only, may be empty; when empty, show realName + payAccount so the customer can transfer to the account)
json
{
  "code": 0,
  "message": "success",
  "data": {
    "order": {
      "orderTime": "2026-10-13 12:00:00",
      "orderNo": "PI1845290017342758912",
      "totalAmount": 100,
      "usdt": 13.7,
      "merchantOrderNo": "A20261013001",
      "currency": "CNY"
    },
    "cards": [
      { "cardId": 1024, "paymentType": 1, "payQrCode": "", "payAccount": "", "realName": "Li Si", "bankName": "ICBC", "bankBranch": "Beijing Haidian", "cardNo": "6222000000000000" }
    ]
  }
}

WARNING

Show the receiving accounts only to this order's customer. Remind them to pay from their own account in the customerName given at order creation, and to pay exactly the order amount.

Common errors ​

Same as for the hosted checkout; in addition, a payment provider failure returns 400.