接口地址
POST/v1/account/payment
创建付款订单分为固定金额和不固定金额,当amount有传值时,为固定金额,否则为不固定金额,即不限定用户的付款金额,
你可以根据业务特性决定使用哪种。
请求参数
参数 | 类型 | 必填 | 描述 |
---|---|---|---|
amount | String | 否 | 支付的金额。当为空时即不限定用户的付款金额。 |
tokenName | String | 是 | 支付的币种名称,例如 USDT 、BTC 等。 |
chainName | String | 是 | 支付所使用的区块链主网名称,例如 Ethereum 、Bsc 等。 |
businessId | String | 否 | 商户自定义的订单唯一标识,支持字母或数字组合,最大长度为 32 字符。 |
timestamp | Long | 是 | UNIX 时间戳(毫秒) |
displayInfo | String | 否 | 商户自定义的订单说明,将显示在支付页面中,便于用户识别订单信息。 |
autoReturn | String | 否 | 支付成功后是否自动跳转回商户页面,默认为 False 。 |
returnUrl | String | 否 | 支付完成后重定向的页面 URL,仅支持 http 或 https 开头。 |
expiryMinutes | String | 否 | 订单的过期时间(分钟),默认 1 小时,最小值为 1 分钟,最大值为 5 天。 |
webhookUrl | String | 否 | 支付完成后的回调 URL,优先于商户全局配置的回调地址。 |
displayLanguage | String | 否 | 支付页面的显示语言,默认为 en-US ,支持:zh-CN ,en-US 。 |
响应参数
参数 | 类型 | 必须 | 描述 |
---|---|---|---|
redirectUrl | String | 是 | 重定向的支付页面。 |
status | String | 是 | 订单状态。 |
id | String | 是 | 平台定义的订单ID。 |
amount | String | 否 | 有设定支付金额时,才有此值 |
minAmount | String | 否 | 不固定金额时,才有此值 |
tokenName | String | 是 | 支付货币 |
chainName | String | 是 | 链名 |
address | String | 是 | 收款地址。 |
businessId | String | 否 | 商户自定义的业务ID。 |
returnUrl | String | 否 | 商户定义的返回页面。 |
displayInfo | String | 否 | 商户自定义的显示信息。 |
createdDate | Long | 是 | 创建时间(UTC) |
expiryDate | Long | 是 | 过期时间(UTC) |