Skip to main content

​
接口地址

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

​
请求参数

参数类型必填描述
amountString否支付的金额。当为空时即不限定用户的付款金额。
tokenNameString是支付的币种名称，例如 USDT、BTC 等。
chainNameString是支付所使用的区块链主网名称，例如 Ethereum、Bsc 等。
businessIdString否商户自定义的订单唯一标识，支持字母或数字组合，最大长度为 32 字符。
timestampLong是UNIX 时间戳（毫秒）
displayInfoString否商户自定义的订单说明，将显示在支付页面中，便于用户识别订单信息。
autoReturnString否支付成功后是否自动跳转回商户页面，默认为 False。
returnUrlString否支付完成后重定向的页面 URL，仅支持 http 或 https 开头。
expiryMinutesString否订单的过期时间（分钟），默认 1 小时，最小值为 1 分钟，最大值为 5 天。
webhookUrlString否支付完成后的回调 URL，优先于商户全局配置的回调地址。
displayLanguageString否支付页面的显示语言，默认为 en-US，支持：zh-CN，en-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": "开通会员服务"
    }
}