创建订单

为一笔收款创建支付订单，系统会自动从地址池中分配一个专属收款地址。

重要规则

规则	说明
精确支付	用户必须向 `pay_address` 转账精确等于 `amount` 的金额，金额不符（多付或少付）均不会自动匹配到本订单
地址独占	每个订单有独立的收款地址，地址在订单有效期内专属使用
幂等性	对同一 `merchant_order_no` 的重复请求具有幂等性，直接返回已创建的订单，不会重复扣费

请求参数校验

参数	必填	校验规则	失败返回 reason
`merchant_order_no`	✅	不能为空、不能全空格、不能为 null	`INVALID_MERCHANT_ORDER_NO`
`amount`	✅	必须是合法十进制字符串、必须 > 0、禁止科学计数法（如 `1e10`）、整数位最多 18 位、小数位数不得超过资产精度（由 `/globalpay/v1/assets/supporte`接口的decimal字段决定）	`INVALID_AMOUNT` / `INVALID_AMOUNT_PRECISION`
`currency` + `chain`	✅	必须是系统已启用的资产组合，不支持则返回	`ASSET_NOT_SUPPORTED`

请求示例代码

Shell

JavaScript

Java

Swift

PHP

Python

HTTP

Objective-C

Ruby

OCaml

Dart

返回响应

🟢200成功

application/json

Bodyapplication/json

示例

{
    "orderHash": "19e14f37cb5-dd9f3d6aef6e41ed",
    "payAddress": "0x47416251a69478c93E9e21451E5f619475562F11",
    "amount": "1",
    "currency": "ETH",
    "chain": "Sepolia testnet",
    "expireAt": "1778468861",
    "status": 1,
    "paymentUrl": "https://dev-pay.bkj.com/payment?order_id=19e14f37cb5-dd9f3d6aef6e41ed",
    "redirectUrl": "www.baidu.com"
}

重要规则#

请求参数校验#

请求参数

请求示例代码

返回响应

重要规则

请求参数校验