接口地址

POST /v1/account/payment
创建付款订单分为固定金额和不固定金额,当amount有传值时,为固定金额,否则为不固定金额,即不限定用户的付款金额, 你可以根据业务特性决定使用哪种。

请求参数

参数类型必填描述
amountString支付的金额。当为空时即不限定用户的付款金额。
tokenNameString支付的币种名称,例如 USDTBTC 等。
chainNameString支付所使用的区块链主网名称,例如 EthereumBsc 等。
businessIdString商户自定义的订单唯一标识,支持字母或数字组合,最大长度为 32 字符。
timestampLongUNIX 时间戳(毫秒)
displayInfoString商户自定义的订单说明,将显示在支付页面中,便于用户识别订单信息。
autoReturnString支付成功后是否自动跳转回商户页面,默认为 False
returnUrlString支付完成后重定向的页面 URL,仅支持 httphttps 开头。
expiryMinutesString订单的过期时间(分钟),默认 1 小时,最小值为 1 分钟,最大值为 5 天。
webhookUrlString支付完成后的回调 URL,优先于商户全局配置的回调地址。
displayLanguageString支付页面的显示语言,默认为 en-US,支持:zh-CNen-US

响应参数

参数类型必须描述
redirectUrlString重定向的支付页面。
statusString订单状态。
idString平台定义的订单ID。
amountString有设定支付金额时,才有此值
minAmountString不固定金额时,才有此值
tokenNameString支付货币
chainNameString链名
addressString收款地址。
businessIdString商户自定义的业务ID。
returnUrlString商户定义的返回页面。
displayInfoString商户自定义的显示信息。
createdDateLong创建时间(UTC)
expiryDateLong过期时间(UTC)

响应示例

{
    "code": 200,
    "msg": "success",
    "timestamp": "1735119737092",
    "data": {
        "createdDate": 1735119737043,
        "expiryDate": 1735123337038,
        "redirectUrl": "https://pay.baaswallet.io/payin/d761cd01-04ab-45e1-b0a8-9e1bc7f84d8d",
        "status": "Pending",
        "id": "626945553984524288",
        "amount": "99.99",
        "tokenName": "USDT",
        "chainName": "Ethereum",
        "address": "0xE8f8f66DB0701a1cE1E2675F833859316C232bD5",
        "businessId": "Bjxc6666",
        "returnUrl": "",
        "displayInfo": "开通会员服务"
    }
}