1. 签名规则

RSA签名规则说明

sign算法说明:参数按键值+数值的ASCII编码顺序拼接,生成signData。使用RSA私钥,通过SHA1withRSA算法,RSA加密统一私钥加密,公钥解密。
RSA公私钥可以通过https://www.bejson.com/enc/rsa/ 获取(密钥长度选择1024bit),或者自己生成密钥

signData示列
amount=100&memberNo=fa521b19e002095b&merchantId=10008&merchantOrderNo=20230630167003&model=821&notifyUrl=https://www.baidu.com&version=1.0.0


RSA私钥加密signData示列
TREA5bSFn62caXvs5PYGslrJdTWdtcE2iyOVzEcl28+YdxnsazP/gJRrfk0eilVtAcpHhvmUisjGQZRQUZewRd9PM33d2AwJ5waStpTPFxjp2H0lvrtPp234aupQBqISxf8PKdBYqBlFZUXtSujTNmKcXGQD0keZOGUE22lCc9Q=

MD5签名规则说明

所有非空参数值的参数按照参数名 ASCII 码从小到大排序(字典序),使用URL键值对的格式(即 key1=value1&key2=value2... )拼接成明文字符串后,使用 MD5 加密生成签名串(32位小写)。

例如:sign = md5( key1=value1&key2=value2...&key=商户密钥 )
回调IP
线上回调IP:
8.217.236.95

常见签名问题说明及排查建议

优化提示: 如遇验签失败,建议首先检查密钥是否正确(可到商户后台重新获取),其次核对参数拼接顺序与内容,确保与文档要求一致,并确认 signType 参数是否正确传递。

2. USDT代收(接口模式)

代收下单网关

生产环境: https://gateway.bishengusdt.com/api/coin/payOrder/create

回调IP: 8.217.236.95

支持格式

JSON

http请求方式

POST

请求参数
参数 必选 参数名称 说明
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
version true 版本号 使用最新版本号 6.0.0
merchantOrderNo true 商户单号 商户创建的订单ID,长度 8~30位
amount true 订单金额 单位:订单币种
最多支持两位小数,如:100.01
此字段需与 coinType 成对使用:
- 当 coinTypeCNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。
- 当 coinTypeUSDT_TRC20 时,amount 即为USDT金额进行代收。
coinType true 订单币种 代收订单实际支付使用的币种,由币种和地址协议拼接组成,
示例:
- coinType=USDT_TRC20
- coinType=CNY
若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
callbackCurrencyCode true 回调币种 回调结果中返回的金额单位,如:USDTCNY
- 若 coinTypeUSDT_TRC20,可回调为 USDTCNY
- 若 coinTypeCNY,则回调币种通常为 CNY
示例:
-coinType=USDT_TRC20,callbackCurrencyCode=USDT
- coinType=USDT_TRC20,callbackCurrencyCode=CNY
- coinType=CNY,callbackCurrencyCode=CNY
callbackExchangeRate false 回调订单汇率 弃用
memberNo false 商户会员号 弃用
rate false 汇率:用于法币换算为 USDT。若 coinType=USDT_TRC20,则该字段无效 6.0.0 或更高版本使用。用于在非 USDT 法币支付(如泰铢)coinType = CNY 时,根据传入的汇率自动换算应收 USDT 数量。
例如:若传入泰铢金额为 1000,汇率为 32.97,则系统自动计算应收 USDT 数量为 30.33(保留两位小数)。
注意:此字段仅在商户需要自行控制汇率时传入,仅支持4位小数;若未传入,则按系统默认商户后台配置的汇率计算。
notifyUrl true 通知地址 订单成功后的回调通知地址
signType false 加密方式 RSA,MD5 (默认RSA)
sign true 签名 参考签名规则
请求参数示例 1:coinType=USDT_TRC20 交易场景
{
      "amount": "10",
      "callbackCurrencyCode": "USDT",
      "callbackExchangeRate": "",
      "coinType": "USDT_TRC20",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "CZ31886553",
      "notifyUrl": "https://baidu.com",
      "sign": "Xh29z+eoX6bvmirx4lakTWIEsPLXNPQgBTw/cJ+/nSDC+OfERHYno0g5k6ASs9lKfl9yFtjlPh226Ag/kmmsG3v5RtdxqAMNE+X7Pr/D7AIopZVDEuxPe14rIsnCtdLmah71dCQLGb81aNn7G6CEP/N2UvOfWgPTrCS+N0RdOjQ=",
      "version": "6.0.0"
}
请求参数示例 2:coinType=CNY 交易场景 (商户传法币金额根据汇率转USDT金额收款)
{
      "amount": "10",
      "callbackCurrencyCode": "CNY",
      "callbackExchangeRate": "",
      "coinType": "CNY",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "CZ69785959",
      "notifyUrl": "https://baidu.com",
      "sign": "g2vm5m9Ra1VDgWVprNw8b4K9qzntTgbbgpVMUeQt7b2YN4KhLPyIkDoN66eAeouvtQPUlj677dIKbCUabfCiXGXUmFmjWc3IcWyASSQQNR1VIb7lbcMHDPewLr76DMys0epXSKCKndh1Cnssgywjg1MnGoLbG4AvZ3raVNUn7vI=",
      "version": "6.0.0"
}
请求参数示例 3:coinType=CNY交易场景(支持动态汇率rate参数)
{
      "amount": "10",
      "callbackCurrencyCode": "CNY",
      "callbackExchangeRate": "",
      "coinType": "CNY",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "CZ56858577",
      "notifyUrl": "https://baidu.com",
      "rate": "8",
      "sign": "Yv8QKLYrbwYiYyvprbyMb9/mgBl9wcMN7vI1TIp1+LDFZMJ/bQWOR4U6c0yER9N9lH9RR7E/W4nt0GkpQ9IWtJED8qSqPFfnT/9g1GpAHkwcS5kommjm2ps25nXLIAzFWzk2uB/QTGUSqo/EAAeAtXVwshVb3KqzzWsyfKxWITU=",
      "version": "6.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功,其他值为失败
msg true 响应信息描述 例:操作成功
merchantOrderNo true 商户单号 商户创建的订单ID
coinType true 订单币种 代收订单实际支付的订单币种,由币种和地址协议拼接组成,如:USDT_TRC20
payCoinAmount true 实际支付金额 订单实际支付的金额,单位:订单币种
bookingAddress true 收款地址 订单币种的接收地址
exchangeRate true 订单汇率 回调金额根据回调币种计算
orderNo true 平台单号 平台创建的订单ID
orderExpireDate true 订单过期时间 订单支付有效时间,超时请勿转入
callbackCurrencyCode true 回调币种 回调结果的,返回订单数量的单位;如:CNY、USDT
sign true 签名 参考签名规则
成功返回参数示例 1:coinType=USDT_TRC20 交易场景
{
      "coinType": "USDT_TRC20",
      "msg": "操作成功",
      "code": "0",
      "orderNo": "CZ202506241839391065350",
      "exchangeRate": "1",
      "payCoinAmount": "10",
      "orderExpireDate": "2025-06-24 18:54:39",
      "callbackCurrencyCode": "USDT",
      "sign": "SJV5mINqEmya2NepT0Cr/v1G5slv4Gej6CxU7E21PZPY4pykH8zYr8hyDLIbu+SY9p9RZWGwjQiulmGtDQjYIaHJj9MhqyA3ow8I7hgM3qepQORe0v06A5y9mev3ZmPfFV3Zy/+APp6KDLdaW0FmDFXs/vrbTQYm93cAsGxYztU=",
      "merchantOrderNo": "CZ31886553",
      "bookingAddress": "TWNn1GqsodkoyTrYKnc6FY5YkS4TM4JFpy"
}
成功返回参数示例 2:coinType=CNY交易场景 (商户传法币金额根据汇率转USDT金额收款)
{
      "coinType": "USDT_TRC20",
      "msg": "操作成功",
      "code": "0",
      "orderNo": "CZ202506241845001065351",
      "exchangeRate": "7.69",
      "payCoinAmount": "1.3",
      "orderExpireDate": "2025-06-24 19:00:00",
      "callbackCurrencyCode": "CNY",
      "sign": "d+IS6pMfhOLGudQsUNNnVclnulsf3jUBx5zZ0oL8sdqaPPWpWU9GVFb81406G2sMgKERw7yxPoRfW/EVe7vEw1wUvTwmEJ8+0DuLRYKUlpPuJLUWPfHVPA/UbD+XfbXd42xxNE2XRue0YOv4H/BQlD3rD7VLfigjx6iyDGQ9gYE=",
      "merchantOrderNo": "CZ69785959",
      "bookingAddress": "TWryFJHVjvswzfV2M9eaCcCV8RHJT5m3UE"
}
成功返回参数示例 3:coinType=CNY交易场景(支持动态汇率rate参数)
{
      "coinType": "USDT_TRC20",
      "msg": "操作成功",
      "code": "0",
      "orderNo": "CZ202506241830531065349",
      "exchangeRate": "8",
      "payCoinAmount": "1.25",
      "orderExpireDate": "2025-06-24 18:45:53",
      "callbackCurrencyCode": "CNY",
      "sign": "efesjWTlxqgKNuxqYa7D5zD40fDfaeyXQAdghJy9C500DKgsd80AHH0UfohwkFBbc5BhBK+CvCQneR0CLkd5+pFQ0WLbkmnW74tiT9IN8qIlNij3W4a5t2z+99YaYS8/0mtTpNjk9HaZJitJBzoIHvRy5PdkU/X5ZjCNNvOzE2Y=",
      "merchantOrderNo": "CZ56858577",
      "bookingAddress": "TWNn1GqsodkoyTrYKnc6FY5YkS4TM4JFpy"
}
失败响应参数示例
{
	"code":"7",
	"msg":"订单号已存在"
}

3. USDT代收(收银台模式)

代收下单网关


生产环境: https://gateway.bishengusdt.com/api/coin/payOrder/createCashier

回调IP: 8.217.236.95

支持格式

JSON

http请求方式

POST

请求参数
参数 必选 参数名称 说明
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
version true 版本号 使用最新版本号 6.0.0
merchantOrderNo true 商户单号 商户创建的订单ID,长度 8~30位
amount true 订单金额 单位:订单币种
最多支持两位小数,如:100.01
此字段需与 coinType 成对使用:
- 当 coinTypeCNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。
- 当 coinTypeUSDT_TRC20 时,amount 即为USDT金额进行代收。
coinType true 订单币种 代收订单实际支付使用的币种,由币种和地址协议拼接组成,
示例:
- coinType=USDT_TRC20
- coinType=CNY
若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
callbackCurrencyCode true 回调币种 回调结果中返回的金额单位,如:USDTCNY
- 若 coinTypeUSDT_TRC20,可回调为 USDTCNY
- 若 coinTypeCNY,则回调币种通常为 CNY
示例:
-coinType=USDT_TRC20,callbackCurrencyCode=USDT
- coinType=USDT_TRC20,callbackCurrencyCode=CNY
- coinType=CNY,callbackCurrencyCode=CNY
notifyUrl true 通知地址 订单成功后的回调通知地址
language true 收银台语言 en(英语), hi(印地语),jp(日语),phl(菲律宾语),pt_br(葡萄牙语_巴西),th(泰语),zh(中文简体),eg(埃及阿拉伯语),vn(越南语言),tr(土耳其语)
callbackExchangeRate false 回调订单汇率 弃用
memberNo false 商户会员号 弃用
returnUrl false 订单成功之后收银台跳转地址
rate false 汇率:用于法币换算为 USDT。若 coinType=USDT_TRC20,则该字段无效 6.0.0 或更高版本使用。用于在非 USDT 法币支付(如泰铢)coinType = CNY 时,根据传入的汇率自动换算应收 USDT 数量。
例如:若传入泰铢金额为 1000,汇率为 32.97,则系统自动计算应收 USDT 数量为 30.33(保留两位小数)。
注意:此字段仅在商户需要自行控制汇率时传入,仅支持4位小数;若未传入,则按系统默认商户后台配置的汇率计算。
signType false 加密方式 RSA,MD5 (默认RSA)
sign true 签名 参考签名规则
请求参数示例 1:coinType=USDT_TRC20 交易场景
{
      "amount": "10",
      "callbackCurrencyCode": "USDT",
      "callbackExchangeRate": "",
      "coinType": "USDT_TRC20",
      "language": "en",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "CZ45478919",
      "notifyUrl": "http://www.baidu.com",
      "rate": "",
      "sign": "amX1EUcNHh8rnelBBzKy9aN3tTdvunbQ/4oJnW5JhgyYEZCUTnDAz0G4B/k/McCXWVq9mblIk9NKOgjhMDSKtR0bW/4Ur9US9UwazuZWCON5N3BIeHxfo6q8qBpn0zx2nO7eAU4dyWtMFzoY1ks+33Uhcp5JXsJo4Ua9LJCqRik=",
      "version": "6.0.0"
}
请求参数示例 2:coinType=CNY 交易场景 (商户传法币金额根据汇率转USDT金额收款)
{
      "amount": "10",
      "callbackCurrencyCode": "CNY",
      "callbackExchangeRate": "",
      "coinType": "CNY",
      "language": "en",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "CZ59418001",
      "notifyUrl": "http://www.baidu.com",
      "rate": "",
      "sign": "UjZQRcbZvg60WPsals5E9w30/l54zuwKWhHcarvrGksrRWJhhUsXbqHbRhZFbbNXd3Un+EPg8CQnkALfMhPTlr1WqxJnHV4Ctsv5dKMGau7GuHwsXj/w+2xWMCTH90q1MHI4sk1bBFvTvZ3qj2Ek066oK+epCZC9IZKEN5SoRjs=",
      "version": "6.0.0"
}
请求参数示例 3:coinType=CNY交易场景(支持动态汇率rate参数)
{
      "amount": "10",
      "callbackCurrencyCode": "CNY",
      "callbackExchangeRate": "",
      "coinType": "CNY",
      "language": "en",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "CZ90916433",
      "notifyUrl": "http://www.baidu.com",
      "rate": "8",
      "sign": "HCHEBiByxWJEsW6o6LzKaKD+TSFliGV8uzoeZJc+L2c5CGm6nPrBMmySscuvNkXUTUl2WHNhgaU15bL/VWemEX0PckQV78HlYvtduWSlGbK48kowahmMi+IL12q5GxeMJaYTnHkNBWOC9agWeBHUgODcupDHl4+X9qqr08Sgr0o=",
      "version": "6.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功,其他值为失败
msg true 响应信息描述 例:操作成功
payUrl true 收银台URL
exchangeRate true 订单汇率
sign true 签名 参考签名规则
成功返回参数示例 1:coinType=USDT_TRC20 交易场景
{
      "msg": "操作成功",
      "code": "0",
      "exchangeRate": "1",
      "sign": "ckCvmdP7m3KDIpkxBq0h6+94MbI7qkntsRXy14q5YwypIkuMR7KqlVwAxeUqYEQ+ZcQPpBnMUVBcaUMRXABpuGE54JPcOE9I+vyQGBWFOd+ZW7/ZsrEJWhzjUMF1Zk1ayVaEYZUc0PDaPsgFTPkA1JA1LwqLfn9JwukbQ6Mr0f0=",
      "payUrl": "http://test-upqp.cfbaopay.com/?orderNo=CZ202506242117201065353&language=en"
}
成功返回参数示例 2:coinType=CNY交易场景 (商户传法币金额根据汇率转USDT金额收款)
{
      "msg": "操作成功",
      "code": "0",
      "exchangeRate": "7.69",
      "sign": "gB/5hO/1xLj0hT/9+Yh8L6wNzRraVk+Ir56XWzrbxFkJZ2y1+y2GKH50XpC8zAvF7QpUwPUKyV8dZxjdVMxwr226x4enu90aqRh8h5o/gTNzNmYK/KZoZjDX1S9AFHVrUzuxGW5O5CzAyL5cRrxgCHfMAniBPrqlYtEh3Bd2JdE=",
      "payUrl": "http://test-upqp.cfbaopay.com/?orderNo=CZ202506242126101065354&language=en"
}
成功返回参数示例 3:coinType=CNY交易场景(支持动态汇率rate参数)
{
      "msg": "操作成功",
      "code": "0",
      "exchangeRate": "8",
      "sign": "CYbeCV/sleVu+FWUJAFJy/RT4SRsAiWGqtlr2obtCDu55ttSvF6BnN9gRF5phWSTRS4uqsdPeV+frfiG5kPEPpYKB3XcC5g37VjeZMDvoGP3xOa8p84kuArwRBbRLi8LlNNZU/2thSwOHmJphTyjY86RReP9CdyqlTRBY2eO8xE=",
      "payUrl": "http://test-upqp.cfbaopay.com/?orderNo=CZ202506242130361065355&language=en"
}
失败响应参数示例
{
      "code": "7",
      "msg": "订单号已存在"
}

4. USDT代收订单查询

代收查询网关

生产环境:https://gateway.bishengusdt.com/api/coin/payOrder/query

支持格式

JSON

http请求方式

POST

请求参数说明
参数 必选 参数名称 说明
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
version true 版本号 使用最新版本号 6.0.0
merchantOrderNo true 商户单号 商户创建的订单ID,长度 8~30位
submitTime true 订单提交时间 格式:yyyyMMddHHmmss (不要求强一致,偏差前后一小时以内,建议传订单创建时间)
signType false 加密方式 RSA,MD5 (默认RSA)
sign true 签名 参考签名规则
请求参数示例
{
    "merchantId": "10008",
    "merchantOrderNo": "20230630167005",
    "sign": "kP+SIMOS9AWMhr1Dz4idGpUWHTC8OtlLgDQsaWEcK0r6tRnRAUxESB5/pVTU7HdbySq3mDcjiGaSNezaIop/hx2UeudMwqFgroRWPlWdMP2o6+8OmrxJs7L5mF7vmrpIYqACaeZjjVRkx4y3/IKFBPd9Iv41Yo/6jeaR4p5fYC8=",
    "submitTime": "20230702013347",
    "version": "6.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功
msg true 响应信息描述 例:操作成功
merchantOrderNo true 商户单号 商户创建的订单ID
amount true 订单金额 单位:订单币种
最多支持两位小数,如:100.01
callbackCurrencyCode true 回调币种
callbackOrderAmount true 回调订单金额 单位:回调币种
supplementOrderState true 补单状态 0未补单、1待审核、2审核通过、-1 审核拒绝
supplementOrderAmount true 补单金额 单位:订单币种
orderCoinAmount true 应收金额 单位:订单币种
payCoinAmount true 实收金额 单位:订单币种
coinType true 订单币种 代收订单实际支付的订单币种,由币种和地址协议拼接组成,如:USDT_TRC20
merchantId true 商户id
status true 订单支付状态 0:处理中,1:成功,2:失败
addFundsCoinAmount true 实际加款金额 如果不是成功那么则是0,版本5.0.0才有此字段
sign true 签名 参考签名规则

响应参数示例
{
      "amount": "100",
      "code": "0",
      "merchantOrderNo": "20230630167005",
      "msg": "操作成功",
      "coinType": "USDT_TRC20",
      "callbackCurrencyCode": "CNY",
      "callbackOrderAmount": "70",
      "merchantId": "10011",
      "supplementOrderState": "2",
      "supplementOrderAmount": "10",
      "sign": "bLGBUfOuHg1mU50zhzf8rjeWP3+nXRUmQM+MRzR9qYAMxF9/OiDRMJ6ONkf8D0tTeJnOqHZub0gAGeKH/ulFh2Q2QagY/bm2hWQbzgrW24tRKUG2C2M4Owq5rZtWRy25Hn0OA2CxHcIGKk2SNrDdtMMBE7SP4Vnv3oWS83yOKEc=",
      "status": "0"
}

5. USDT代付下单

代付请求网关

生产环境:https://gateway.bishengusdt.com/api/coin/remitOrder/create
回调IP: 8.217.236.95

支持格式

JSON

http请求方式

POST

请求参数说明
参数 必选 参数名称 说明
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
version true 版本号 使用最新版本号 6.0.0
merchantOrderNo true 商户单号 商户创建的订单ID,长度 8~30位
amount true 订单金额 单位:订单币种
最多支持两位小数,如:100.01
此字段需与 coinType 成对使用:
- 当 coinTypeCNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。
- 当 coinTypeUSDT_TRC20 时,amount 即为USDT金额进行代收。
coinType true 订单币种 代收订单实际支付使用的币种,由币种和地址协议拼接组成,
示例:
- coinType=USDT_TRC20
- coinType=CNY
若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
bookingAddress true 收款地址 订单币种的接收地址
callbackCurrencyCode true 回调币种 回调结果中返回的金额单位,如:USDTCNY
- 若 coinTypeUSDT_TRC20,可回调为 USDTCNY
- 若 coinTypeCNY,则回调币种通常为 CNY
示例:
-coinType=USDT_TRC20,callbackCurrencyCode=USDT
- coinType=USDT_TRC20,callbackCurrencyCode=CNY
- coinType=CNY,callbackCurrencyCode=CNY
notifyUrl true 通知地址
callbackExchangeRate false 回调订单汇率 弃用
memberNo false 商户会员号 弃用
signType false 加密方式 RSA,MD5 (默认RSA)
rate false 汇率:用于法币换算为 USDT。若 coinType=USDT_TRC20,则该字段无效 6.0.0 或更高版本使用。用于在非 USDT 法币支付(如泰铢)coinType = CNY 时,根据传入的汇率自动换算应收 USDT 数量。
例如:若传入泰铢金额为 1000,汇率为 32.97,则系统自动计算应收 USDT 数量为 30.33(保留两位小数)。
注意:此字段仅在商户需要自行控制汇率时传入,仅支持2位小数;若未传入,则按系统默认商户后台配置的汇率计算。
remark false 此字段可用于附加信息 附加信息
sign true 签名 参考签名规则
请求参数示例 1:coinType=USDT_TRC20 交易场景
{
      "amount": "10",
      "bookingAddress": "TBCwRrYLeBi9GZqDdeAiDToXzx12345678",
      "callbackCurrencyCode": "USDT",
      "callbackExchangeRate": "",
      "coinType": "USDT_TRC20",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "DF33816566",
      "notifyUrl": "https://baidu.com",
      "rate": "",
      "remark": "bzx12345678",
      "sign": "XE0plHgZ3640s+seP1M0woeXJ9F/JskintKlYoz4UsZio5gawVMjQB8vDPM43ZUkchLaAMFotCagiUumyk+GtUJ365w5rMIzqoT8D9BOHtaTTBADDUhz4i8rQ59jy2EAJjAozh/pNytPY3BTtXhBJM6yXu5Z4Awn+V7l01eInpU=",
      "version": "6.0.0"
}
请求参数示例 2:coinType=CNY 交易场景 (商户传法币金额根据汇率转USDT金额收款)
{
      "amount": "10",
      "bookingAddress": "TBCwRrYLeBi9GZqDdeAiDToXzx12345678",
      "callbackCurrencyCode": "CNY",
      "callbackExchangeRate": "",
      "coinType": "CNY",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "DF82898135",
      "notifyUrl": "https://baidu.com",
      "rate": "",
      "remark": "bzx12345678",
      "sign": "XpZ1GBj0WgEWdgcOa2oRpYRNvXBCehHKU2DzvdWOoXipUDk9kwInHA1ykbaS247MFAuYTEnHgALAk9UOyGk3elKHf2qhuAu0p/xPJsFbKsXLQ+e3AZRevthOt3aCMTIk0TR6mGohq6o2SMQQTVnlI6o9Fh9sBBFSk1imOcmeelI=",
      "version": "6.0.0"
}
请求参数示例 3:coinType=CNY交易场景(支持动态汇率rate参数)
{
      "amount": "10",
      "bookingAddress": "TBCwRrYLeBi9GZqDdeAiDToXzx12345678",
      "callbackCurrencyCode": "CNY",
      "callbackExchangeRate": "",
      "coinType": "CNY",
      "memberNo": "",
      "merchantId": "10216",
      "merchantOrderNo": "DF52134284",
      "notifyUrl": "https://baidu.com",
      "rate": "8",
      "remark": "bzx12345678",
      "sign": "Ip7JvdmsMCEoMCWv0ZLyqqNqtPuf1jdJxA0LyrNG7iIotqxlQsuU81a78XCYMCgQtFtiBmrBk6j+l6n3ggkII9NyMoBeHXnUcLZl65xSvps0q8aScTYK6Fh0L1r3Fb7yrjIVSawKVBsqIZka2prwSdJIt4hbmHQ3KjhqsfzBrg4=",
      "version": "6.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功,其他值为失败
msg true 响应信息描述 例:操作成功
merchantOrderNo true 商户单号 商户创建的订单ID
amount true 订单金额 单位:订单币种
最多支持两位小数,如:100.01
exchangeRate true 汇率
remitCoinAmount true 出币数量
status true 订单支付状态 0:处理中,1:成功,2:失败
sign true 签名 参考签名规则
响应参数示例
成功返回参数示例 1:coinType=USDT_TRC20 交易场景
{
  "amount": "10",
  "code": "0",
  "exchangeRate": "1",
  "merchantOrderNo": "DF33816566",
  "msg": "操作成功",
  "remitCoinAmount": "10.0000",
  "sign": "eZMSGpTeIzpggcgUh+bedL0ypJYyzWN95hgiTG3lxyGIS7BtLccb7e1rXYmYTc7ze0InhrSqAdsTZtD0L13jk0IiCpyk2+ucnTxaR90xv5Z3Z/BkWiMPz9odzZo88JGk3McoVVrADWU4vmmzmGLqlT8tsCc877ORaHM3C1pF5fo=",
  "status": "0"
}
成功返回参数示例 2:coinType=CNY交易场景 (商户传法币金额根据汇率转USDT金额收款)
{
  "amount": "1.39",
  "code": "0",
  "exchangeRate": "1",
  "merchantOrderNo": "DF82898135",
  "msg": "操作成功",
  "remitCoinAmount": "1.3900",
  "sign": "KG10yCTr+eKwbsFOzhqiBxpOkS9ifU4wJiXX+RduJaRzinrnB1WpqaCpswP/spQeyfHFdNuA4Nref42/lNVP/po1DreoeWurd8+IDDDXTuu7JYQOZU1yqbfxNMAWWA61jJxMzNiDuMd4KcRVUxNFHK7C7EJR9HIbVEKN5BWvqaQ=",
  "status": "0"
}
成功返回参数示例 3:coinType=CNY交易场景(支持动态汇率rate参数)
{
  "amount": "1.25",
  "code": "0",
  "exchangeRate": "1",
  "merchantOrderNo": "DF52134284",
  "msg": "操作成功",
  "remitCoinAmount": "1.2500",
  "sign": "KIyltFR9zPJRWmIFEhEx04lYlGdRX1tiModkmDCJG6mWg2riJj0HECEYEv1gvbQYXA0V4IOuXIng6rkaOY0lieuq1/G9i7FRg7rYCsHxvIO+c/5BGpjyEf1pSecfDKATRdpbtLfYW5pHuEGeneNhrB4BPmnCIwOmOEYmBvr9R6c=",
  "status": "0"
}

6. USDT代付订单查询

代付订单查询网关

生产环境:https://gateway.bishengusdt.com/api/coin/remitOrder/query

支持格式

JSON

http请求方式

POST

请求参数说明
参数 必选 参数名称 说明
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
version true 版本号 6.0.0
merchantOrderNo true 商户单号 商户创建的订单ID,长度 8~30位
submitTime true 订单提交时间 格式:yyyyMMddHHmmss (不要求强一致,偏差前后一小时以内,建议传订单创建时间)
signType false 加密方式 RSA,MD5 (默认RSA)
sign true 签名 参考签名规则
请求参数示例
{
  "merchantId": "10216",
  "merchantOrderNo": "DF20795270",
  "sign": "f1erVuk2qNghoMOb8JGANgso/R6xpJT/HtMJziFKLzlolGHGORHFIu4oatoMAwaBcwQby03LEqUIIAxzqN2WpP/DW/V6GcP/dx0J5BwEAvRqt6O5GwU8Cng++nC/caaXzG7OttnzD02PWvm4O5Mu9UGXY9CitewD+DnrM3Wn4pI=",
  "submitTime": "20250625211928",
  "version": "6.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功,其他值为失败
msg true 响应信息描述 例:操作成功
merchantOrderNo true 商户单号 商户创建的订单ID
amount true 订单金额 单位:订单币种
最多支持两位小数,如:100.01
exchangeRate true 汇率
remitCoinAmount true 实际出币数量
status true 订单支付状态 0:处理中,1:成功,2:失败
sign true 签名 参考签名规则
响应参数示例
{
  "amount": "1.25",
  "code": "0",
  "exchangeRate": "1.0000",
  "merchantOrderNo": "DF20795270",
  "msg": "操作成功",
  "remitCoinAmount": "1.2500",
  "sign": "JU6O5cfUo795nMGp9IR9YLMSl3u1dwpEha5jkvXvvHN2W3B87rwf3Afu2kiwTiCa78FH/nbAOeMm8KUHK7m6PVGsOk3m4UN69VA5O1vw0tAEueuwdFwCPnFbsllPw0Nbn+rx/MG3BeU1S9qybrkEiRVoPLVKv1brpHzLQWNxq34=",
  "status": "1"
}

7. 代收回调通知

参数 必选 参数名称 说明
merchantOrderNo true 商户订单号
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
amount true 应收金额 单位:订单币种
最多支持两位小数,如:100.01
此字段需与 coinType 成对使用:
- 当 coinTypeCNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。
- 当 coinTypeUSDT_TRC20 时,amount 即为USDT金额进行代收。
coinType true 订单币种 代收订单实际支付使用的币种,由币种和地址协议拼接组成,
示例:
- coinType=USDT_TRC20
- coinType=CNY
若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
payCoinAmount true 实收金额 单位:订单币种
最多支持两位小数,如:100.01
callbackCurrencyCode true 回调币种
callbackOrderAmount true 回调金额 单位:回调币种(如果用CNY计算,以callbackOrderAmount回调金额上分。)
supplementOrderState true 补单状态 0未补单、1待审核、2审核通过、-1 审核拒绝
supplementOrderRemark true 补单备注
status true 订单支付状态 0:处理中,1:成功,2:失败
sign true 签名 参考签名规则
currencyOrderAmount false 法币订单金额 6.0.0
addFundsCoinAmount false 实际加款金额 6.0.0 , 如果不是成功那么则是0,(实际支付金额-商户手续费=商户实际到账金额)
rate false 汇率 6.0.0,回调4位小数

回调验证成功后返回 success 字符串

虚拟币回调会兼容+-20% 订单金额回调,请注意用真实金额上分!!!

示例 8:coinType=USDT_TRC20, callbackCurrencyCode=USDT 交易场景
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "USDT",
  "callbackExchangeRate": "",
  "coinType": "USDT_TRC20",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ45901837",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "sign": "ZOVS8Lq97kWe0FKw8bsSrB2ePcdrhKsg0OkxoAsmXEdqmgBKGRW3pJeDpEmi6WlQtUV8GcnvBAzC97Ffax87PDw8NopFvUZKuGfvt3GuLpZsR8JRK0GE33yFya6DV3hui8LDrr2JS1XCL7ywbpX7C/uznJ5iboGhuXlW515vTTg=",
  "version": "6.0.0"
}
成功回调参数
{
  "addFundsCoinAmount": "10",
  "amount": "10",
  "callbackCurrencyCode": "USDT",
  "callbackOrderAmount": "10",
  "coinType": "USDT_TRC20",
  "currencyOrderAmount": "0",
  "merchantId": "10216",
  "merchantOrderNo": "CZ45901837",
  "payCoinAmount": "10",
  "sign": "KrMHt96XZe964Thkun9DBFqpEvJR8yfidfBAvqx/uVqDPKvsEO2YozsMCO63OXn/y7/8zauc3qhSimk1caW6KcvHevNAzv4blumkDrXufsiJXfOvNwsVfbmBsveP+wZsAqscu+P5a/BaW5pJ1Kx9OP3VygavW8viYdU9+KCGJWc=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}
示例 7:coinType=USDT_TRC20, callbackCurrencyCode=CNY 交易场景
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "USDT_TRC20",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ97764613",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "sign": "aFvPBUIgWrAEgQb/M40Mc8YVqXgw0RUaIiuOQzyvGt1GC+rDWu3Sh4YpkbojsPbCeWK4h8jrp6P/Sz4+gLNxSuRV0+TNBAfV0SF9uxdpmAd92tpN7vYJJsovuvGFVhXpYtgLP6JCladgiWCOO3VSsuHHOMAqHcJ3zz7mHTqralI=",
  "version": "6.0.0"
}
成功回调参数
{
  "addFundsCoinAmount": "10",
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "76.8",
  "coinType": "USDT_TRC20",
  "currencyOrderAmount": "0",
  "merchantId": "10216",
  "merchantOrderNo": "CZ97764613",
  "payCoinAmount": "10",
  "sign": "PQQ2VOWqjFVwxfpwyhQlYhZoRmv13wUQNCDFOMMBNkkFnSvQ1tJiV15MALLuX7AudnGk5gTU0amhb16Do5ShdNm+gqki5v2IJZMgBc1aO4285pWX0h9u0I2dgB8UZp8m930/vCdjYNmb33ZCc8M3cO5JZraCKhYYFIGKpAJRPyg=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}
示例 6:coinType=CNY交易场景, callbackCurrencyCode=CNY (商户传法币金额根据汇率转USDT金额收款)
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ4408491",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "sign": "FqYglovBGP8NIMCk4XM3KcO8iwC4wiUBkJ3P08dvfUVyX8yNNDdFGvszp9ctW8Umw0+DuvXmyaX5DHqz/LRTYxD6dJ+YRh3dOPWdH2yNJp622AHmZYafAebQVZg96lKVimcRa5r+6WSehtpbIXpNVcCv/3LruFZoEqb50k5g4uk=",
  "version": "6.0.0"
}
成功回调返回参数示例
{
  "addFundsCoinAmount": "1.3",
  "amount": "1.3",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "9.98",
  "coinType": "USDT_TRC20",
  "currencyOrderAmount": "10",
  "merchantId": "10216",
  "merchantOrderNo": "CZ4408491",
  "payCoinAmount": "1.3",
  "sign": "D93vY1icw5BKBrbNjII5VY/Fnzs8n4+xcWlv8geP3yOo/cJIL/h9goWZuF9LXcg70wKhXGw+u/dYBDA3wJ6Unmvh2yI0JpJiphkWJevu5+6GH3hwIO0HAzFkFx3giu/XCezDkkkYgoZatY/r/l9XZhBEiLN3etWLnZQbPY4CoJM=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}
示例 5:coinType=CNY, callbackCurrencyCode=CNY , version=6.0.0 交易场景(支持动态汇率rate参数)
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ93863393",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "8",
  "sign": "QiE7sx8/rJNSCU3oJ1s9Hq94Yb5IMzJiFk6f4+tH4/j7V0P6QYxECkkgZJk7yYqheLyqHqaFjFrNU0xNQ4k7W6lHVVh9SOQyYucoFUVn+HjanhxqQFg68+JTz9gswfwhi+ZYkxjIwhGPZanS4ZjN5yTogJAhIR2DnNW7Nq77vdc=",
  "version": "6.0.0"
}
成功回调返回参数示例
{
  "addFundsCoinAmount": "1.25",
  "amount": "1.25",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "10",
  "coinType": "USDT_TRC20",
  "currencyOrderAmount": "10",
  "merchantId": "10216",
  "merchantOrderNo": "CZ93863393",
  "payCoinAmount": "1.25",
  "sign": "nvviYu/0d6BapvQSNyoov1GGg2mOH0YmxAlM2ZZiRDWmce9AxGAdguCtjxXEAmdntKYA07dmIylSDJC50xYIbxz68ckq6Ad1tX0LvTcE9oP0QKSzSKHWohqc2ha8Q+FLmmb45eL8XzaRU74KLGNs8c6thRJU66aCB3q/74B+/Qg=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}
示例 4:coinType=CNY, callbackCurrencyCode=CNY , version=5.0.0
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ6026603",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "sign": "ildQl0uUd33Wuv4ONj1sMd/mR5ipIR2kyv+rLl44E+ag0WUQUb15kE9KlGvzl3bN9VBXXDEPWVOoYeaAZiQ6akKJ7laphN/x2S9o4sG+09whnSrZgTErT/Kt664Z0Pq4ALLhKlzcfyTWI9zQCKh3KK97Rm4AznxNYxCbiq0XY84=",
  "version": "5.0.0"
}
成功回调返回参数示例
{
  "addFundsCoinAmount": "1.3",
  "amount": "1.3",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "9.98",
  "coinType": "USDT_TRC20",
  "currencyOrderAmount": "10",
  "merchantId": "10216",
  "merchantOrderNo": "CZ6026603",
  "payCoinAmount": "1.3",
  "sign": "aKmzrB4cNzBkVEUBze+vCo2q37NUJiG7Dn5wDybJnsQPpFyr8VqK4wAbQ+/kGyuiiuhUrSQKp7FPIcmX9PSslOQTu+y4g0GxHc+B8zlHcV8ZIw5LoZPT/LDFdsG2DntmUUUZLswkwk6FfoRoVf6DSXsfyTTpmIZcHWqQCR2DsYU=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}
示例 3:coinType=CNY, callbackCurrencyCode=CNY , version=4.0.0
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ46273355",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "sign": "hgK4nslT18zMFUD47RhnxtoND4MtDAbCnk5ml8RkPkDLGEyNnQR/A6xp0X/ZSTZXCVn5vl7+mcvECNEl9aDYbLt570zQ19U32Ng0F6Beeo+IroE3XYe8bPvtATLVvA84v0LgumZKjhrTcqf6nlF7SgDn/qK0FmXVOIllcq6Fo8E=",
  "version": "4.0.0"
}
成功回调返回参数示例
{
  "amount": "1.3",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "9.98",
  "coinType": "USDT_TRC20",
  "currencyOrderAmount": "10",
  "merchantId": "10216",
  "merchantOrderNo": "CZ46273355",
  "payCoinAmount": "1.3",
  "sign": "IRmURmYrBs2ATAJE5Azw1lSY3EeRfiRBn3yhuEds+I7PGZGgmRy25WzfS5/tPm9mVzKd2KH5qoQjyiH9gYb+NSjgiM8gIP+uwwKiXw8u0ccUXBD3WIxxP4bnp2ukU52LXvCjbtsXjogV4LhuaL4zeQzaOLaSmvlXL4yII19voqQ=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}
示例 2:coinType=CNY, callbackCurrencyCode=CNY , version=3.0.0
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ34124151",
  "notifyUrl": "http://www.baidu.com",
  "rate": "",
  "sign": "Z4l2f0SAjKsUVG32Ic8jyvBeDTX0xQIv+XOTfC9wifquW4zuTrUExkKLrvHtQqPGNiddJCIkMTSVxfozUcAwRHzH3L3wop3hGpRD+ZEUYeQ0dVBtl/fM7CzhFxdSWlZPKfK55v7mHcvk82Q4Z2k4T+2YqCG3pVmjG2nubbLZB0A=",
  "version": "3.0.0"
}
成功回调返回参数示例
{
  "amount": "1.3",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "9.98",
  "coinType": "USDT_TRC20",
  "currencyOrderAmount": "10",
  "merchantId": "10216",
  "merchantOrderNo": "CZ34124151",
  "payCoinAmount": "1.3",
  "sign": "lHGmnNTwDbKOs0RGjMWQ4cfwsk7ovZjda5dXzis+FJxL3byDXwu+p1THXTRuyQTr/1YEigND6/r5DO8G86f4htGpodsjff6/1l5BsOM5NCahAkpvFnri0aFpK+fE3dvuF78tZKp0TUPg9o11S+fCxIsNZjvF4sc9Oy1OZGtN7z8=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}
示例 1:coinType=CNY, callbackCurrencyCode=CNY , version=2.0.0
请求参数
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "language": "en",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "CZ14890746",
  "notifyUrl": "http://www.baidu.com",
  "rate": "",
  "sign": "SUjtApR0zvI0P6EJx8oS+nHCd+qrofcmJ0ixsCs2bzJT7Ia1W/0fk9Vd6LPvya3wTY5flq6d/reJitKJEAUGKIOIfVULEvbMbx5Avnp+IMGOqiBw10ECIfYvUwvX1A8tvcyZrj7bsbmOK0VoUPs27MU9M2fCZCAkl7dWdLJk5UE=",
  "version": "2.0.0"
}
成功回调返回参数示例
{
  "amount": "1.3",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "9.98",
  "coinType": "USDT_TRC20",
  "merchantId": "10216",
  "merchantOrderNo": "CZ14890746",
  "payCoinAmount": "1.3",
  "sign": "Cmo3gESMIqW1YfWcxn0ThtQVW58JoPs7fX4lUhg7RzetsGgxpwL1T+yxIX8urGLqQAI7OGXtQCEtovftCt6LNfzj32ukCPBAD+3BTow723BdqUOt/aalN6hbv/VJZhLRq8y19AW65u/srf7yiiWtoE6+b3gUS/7WczmM5sSnxaE=",
  "status": "1",
  "supplementOrderRemark": "",
  "supplementOrderState": "0"
}

8. 代付回调通知

参数 必选 参数名称 说明
merchantOrderNo true 商户订单号 商户创建的订单ID,长度 8~30位
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
exchangeRate true 汇率
amount true 订单金额 单位:订单币种
最多支持两位小数,如:100.01
此字段需与 coinType 成对使用:
- 当 coinTypeCNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。
- 当 coinTypeUSDT_TRC20 时,amount 即为USDT金额进行代收。
coinType true 订单币种 代收订单实际支付使用的币种,由币种和地址协议拼接组成,
示例:
- coinType=USDT_TRC20
- coinType=CNY
若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
remitCoinAmount true 实际出币数量 单位:订单币种
最多支持两位小数,如:100.01
callbackCurrencyCode true 回调币种
callbackOrderAmount true 回调金额 单位:回调币种(如果用CNY计算,以callbackOrderAmount回调金额上分。)
status true 订单支付状态 0:处理中,1:成功,2:失败
rate false 传入汇率 6.0.0,回调4位小数
sign true 签名 参考签名规则

回调验证成功后返回 success 字符串

示例 1:coinType=USDT_TRC20,callbackCurrencyCode=USDT 交易场景
代付请求参数示例
{
  "amount": "10",
  "bookingAddress": "TBCwRrYLeBi9GZqDdeAiDToXzx12345678",
  "callbackCurrencyCode": "USDT",
  "callbackExchangeRate": "",
  "coinType": "USDT_TRC20",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "DF78643317",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "remark": "bzx12345678",
  "sign": "PgWqzNtWk6ctH5AR8fJKJklHg+qK+2LnrHBGE/raumuhNLJjfG4ff5u/Y0b6NzhT+KLoK2h8Mbd3zRCwvhCGCaKC+R0cFo3i4OgCGT5s7LnQPPVFmnk+teEJiNMrPJ0ZAV5AHPYicAClpndbdZ6H0JxBBRi2S9uiuFlRA3Tbp8g=",
  "version": "6.0.0"
}
代付成功回调参数示例
{
  "amount": "10",
  "callbackCurrencyCode": "USDT",
  "callbackOrderAmount": "10",
  "coinType": "USDT_TRC20",
  "exchangeRate": "1.0000",
  "merchantId": "10216",
  "merchantOrderNo": "DF78643317",
  "remitCoinAmount": "10.0000",
  "sign": "PpFNf/X79SItqVpRcjZXxZwdeZutPbvcvXPUzbd9v4wDLRwyuIldaTeROLbKWJxNv6HidsN0oj+RKB3c1YKIIlWeRl0riVLxLSQT7IJsUJdWBz6LDyyeGKevZWeaR5IturOCGlWIQeBP8ncJeMJUJEWeEFxFnLHfAr02UpcKlh4=",
  "status": "1"
}
示例 2:coinType=USDT_TRC20,callbackCurrencyCode=CNY 交易场景
代付请求参数示例
{
  "amount": "10",
  "bookingAddress": "TBCwRrYLeBi9GZqDdeAiDToXzx12345678",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "USDT_TRC20",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "DF59491645",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "remark": "bzx12345678",
  "sign": "ITKVuOxX07B8qvRSElwN0uvpMyYTbpYcYk4Af9XV4KsH6zF/aVra/3rd90ffS0O8BO5d1sgFcaNAV+RNnmLWll6SmEl00ypsBqzKwm30g4+IsDPMEC5KVDRXycriCHUzqEnYQYiswkiNFRJPcjRg6Tz68csaLZaAhugEPZhdDWc=",
  "version": "6.0.0"
}
代付成功回调参数示例
{
  "amount": "10",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "71.8",
  "coinType": "USDT_TRC20",
  "exchangeRate": "1.0000",
  "merchantId": "10216",
  "merchantOrderNo": "DF59491645",
  "remitCoinAmount": "10.0000",
  "sign": "PRlvXyV7GwKH03nGjbyfU6N8sD4WmoKszbTMLfEbzGcPWxzoFMHd3gW7luXCHic8dcnnF66zW4z3Rh874f6X3o67ggi1oPeho5PBffdd3O8VGsLh51TIj9XVxX0y8BWPDz4pZTMlz5IjR91ZXJSBeOvxuxcSNGtb5xhYufpv2CE=",
  "status": "1"
}
示例 3:coinType=CNY,callbackCurrencyCode=CNY 交易场景(商户传法币金额根据汇率转USDT金额收款)
代付请求参数示例
{
  "amount": "10",
  "bookingAddress": "TBCwRrYLeBi9GZqDdeAiDToXzx12345678",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "DF8026515",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "",
  "remark": "bzx12345678",
  "sign": "Ah0CRxjG8r0ATkRtqPO1O95w2sYJ4EaIV7VA9zkh6KeUDuUcNWyCURf+OO8I+rpk0roKsp4CR3etzFpHGsrnRCOkxwd4Ywh6Ul3Xk7fKPNvips5aWMpGkHOzPLkOrRwXs/Krfn3y7i42j1u9OALr/9OHdu5qUwWY2ejyl12UsXA=",
  "version": "6.0.0"
}
代付成功回调参数示例
{
  "amount": "1.39",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "9.98",
  "coinType": "USDT_TRC20",
  "exchangeRate": "1.0000",
  "merchantId": "10216",
  "merchantOrderNo": "DF8026515",
  "remitCoinAmount": "1.3900",
  "sign": "A1EAfgYPTSKvQGJnQ/Vylet3mC+hSu+nRWaj37X27jZy/MeiGGQQDpjxx+9jK+xTip08pGnroHBR8DgoNmqFQbRNYaUJorRLTSiRaoPG5/00AgXEYAzM5kLcVxsDAJBfmb60qfAY7MjonJJrCsb4ysrEv/8xJGMg+1NXdI+f8KI=",
  "status": "1"
}
示例 4:coinType=CNY,callbackCurrencyCode=CNY,rate=8 交易场景(支持动态汇率rate参数)
代付请求参数示例
{
  "amount": "10",
  "bookingAddress": "TBCwRrYLeBi9GZqDdeAiDToXzx12345678",
  "callbackCurrencyCode": "CNY",
  "callbackExchangeRate": "",
  "coinType": "CNY",
  "memberNo": "",
  "merchantId": "10216",
  "merchantOrderNo": "DF91047231",
  "notifyUrl": "https://test-gateway.cfbaopay.com/api/payOrder/testNotifySuccess",
  "rate": "8",
  "remark": "bzx12345678",
  "sign": "CKMbg6wllXT28cVm5krgCI9NBX5qmrl5Z4Gb2J8ZLJ1wcNWCS7YzEBjLBv28sbDDWmAetm+j73BSGMe9X7BIW9R89lKUNqCqgj3TwZkC21IC2XwhJLJe711Ji3RJLdEt9oBQlWD5qKKgXuxD2GnWoWin/UMyqHrZ3cLvv2cDvCI=",
  "version": "6.0.0"
}
代付成功回调参数示例
{
  "amount": "1.25",
  "callbackCurrencyCode": "CNY",
  "callbackOrderAmount": "10",
  "coinType": "USDT_TRC20",
  "exchangeRate": "1.0000",
  "merchantId": "10216",
  "merchantOrderNo": "DF91047231",
  "remitCoinAmount": "1.2500",
  "sign": "MjZsKE9qfegLVu6pWOfTsbh8l5oAUHskWvkE5PZ/6MPUXV2vxd5T/kIc1WeVStiakFljRoO9aq5IFJWKC5wRK8A+XZCRbR3Zjmng850L5U/TKm08Cryb7tnECN2q+Evo0nqeFieAv3fnrQ9ncrQB+8cNHPntcPZ7sfBBgbN0JqA=",
  "status": "1"
}

9. 余额查询

余额查询网关

生产环境:https://gateway.bishengusdt.com/api/coin/balance/query

支持格式

JSON

http请求方式

POST

请求参数说明
参数 必选 参数名称 说明
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
version true 版本号 6.0.0
requestTime true 请求时间 格式:yyyyMMddHHmmss (不要求强一致,偏差前后一小时以内)
coinType true 币种 如:USDT
sign true 签名 参考签名规则
请求参数示例
{
	"merchantId": "80008",
	"coinType": "USDT",
	"requestTime": "20230702014951",
	"sign": "lz9pKC1HofY8hjuvFZgH4xTw3+exKY/CB5CAwGNeNJdWJesi3Bm6RHieQ8iDhfv6CfvbAQusH2zfg1OPAEBDddwow//ZTVWFw5xvs4tv8gCv23rsfTHDiUNE0qUKHspaYrqYFwxua197U4ylOo3D8gI1D6/8pKzez08ZNU32cz0=",
	"version": "6.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功,其他值为失败
msg true 响应信息描述 例:操作成功
availableAmount true 可用金额 单位:币种单位
frozenAmount true 冻结金额 单位:币种单位
unsettledAmount true 待结算金额 单位:币种单位
sign true 签名 参考签名规则
返回参数示例
{
    "availableAmount": "780.676",
    "code": "0",
    "frozenAmount": "0",
    "msg": "操作成功",
    "sign": "LRiC08KRvEzKdJ3C4mWVGWXyqW9fg96jzARfeFv7r/bdVOQ2PqZiZv0lmzhMYycZyjVj0rp+2p/XihfqqYy6wbJtXDabuUVeWf8TLpVUteb3i56Qp08Ao6y/fMuWcbik+VjjnOYtJCyQo/4KN3UQXkBAxfCQGpIWGKOCijzd29k=",
    "unsettledAmount": "0"
  }

10. API代付反查请求

反查参数说明 (需要商户提供对外反查api给我方,我方按照下列参数格式反查订单)
参数 必选 参数名称 说明
merchantOrderNo true 商户订单号 商户创建的订单ID,长度 8~30位
amount true 金额 单位:元
merchantId true 商户id 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
coinType true 订单币种,链 USDT_TRC20
bookingAddress true 入账地址 订单币种链上地址
remark true 此字段可用于附加信息 附加信息
sign true 签名 详情见签名规则
反查参数示例
{
    "amount":"100",
    "bookingAddress":"TPHWprt9oCAW5Kaia3enbYcz4idJY6oyTj",
    "coinType":"USDT_TRC20",
    "merchantId":"10008",
    "merchantOrderNo":"2023062120200807",
    "remark":"gKJmoBLHYvoIBYMCH",
    "sign":"F+lWyTBkuCDtgKJmoBLHYvoIBYMCHvp7kCK7a9sg8ld8oi+M+dS5QnMhQeYohBribWiHpsu9BwI8QPhxj0b3K6Z8oWhRGDqwRdk3qk8rk2dpfzp+8/h/PB4yCchW1sd8JZUuvFdoBz9ASr3S7MHd0qXVvCQV5CUtlCdtpgsA3i0="
}
响应参数说明参数说明 (由商户按这个参数形式制定响应,由code字段跟message字段描述订单反查是否成功)
参数 必选 参数名称 说明
merchantOrderNo true 商户订单号 商户创建的订单ID,长度 8~30位
code true 操作状态 0: 操作成功
其它值为失败
message true 操作描述 操作描述 (成功或者失败)
sign true 签名 详情见签名规则

11. 闪付获取/查询用户币地址

余额查询网关

生产环境: https://gateway.bishengusdt.com/api/coin/quick/queryAddress

回调IP: 8.217.236.95

支持格式

JSON

HTTP请求方式

POST

请求参数说明
参数 必选 参数名称 说明
merchantId true 商户id 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
version true 版本号 6.0.0
memberNo ture 用户唯一标识
coinType true 币种 USDT_TRC20
sign true 签名 详情见签名规则
请求参数示例
{
	"merchantId": "80008",
	"coinType": "USDT_TRC20",
	"memberNo": "20230702014951",
	"sign": "lz9pKC1HofY8hjuvFZgH4xTw3+exKY/CB5CAwGNeNJdWJesi3Bm6RHieQ8iDhfv6CfvbAQusH2zfg1OPAEBDddwow//ZTVWFw5xvs4tv8gCv23rsfTHDiUNE0qUKHspaYrqYFwxua197U4ylOo3D8gI1D6/8pKzez08ZNU32cz0=",
	"version": "1.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功,其他状态为失败
msg true 响应信息描述 例:操作成功
coinType true 币种 USDT_TRC20
address true 地址 链上地址
cnyConvertUsdtRate true cny转u的汇率 7.28
sign true 签名 详情见签名规则
响应参数示例
{	
	"code":"0",
	"coinType":"USDT_TRC20",
	"cnyConvertUsdtRate":"7.28",
	"msg":"操作成功",
	"address":"TAbY4NRrLwP3x6PksCQCmSpuvJV6MtGC9w",
	"sign":"Ul7c0PXG0IJTc+sUa8mgPWtsX/H/Vh7NHPhnpc1xjLwsG2VU0ShC5oibvOqiXobe1cJsIEycWeGnpF1GYE7eSUZWfnvz6ZdxR7JQK4M4fnh1KpiTXPeAgxwbJEaylJ0Co3p/8ZYGVIz0mhuDw9yJZNFx4zZguPykv20fsHFhhqQ="
}

12. 闪付支付结果通知

异步回调参数说明 (闪付支付结果通知)
参数 必选 参数名称 说明
merchantOrderNo true 商户订单号,平台自动生成
orderNo true 平台订单号,平台自动生成
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
coinType true 订单币种 USDT_TRC20
memberNo true 商户会员号
bookingAddress true 入账地址 充值入账的地址
payAddress true 支付地址 充值支付的地址
cnyConvertUsdtRate true cny转u的汇率 7.28
quickState true 是否是闪付订单 1是
payCoinAmount true 订单数额 订单数额:单位订单币种
status true 订单支付状态 0:处理中
1:成功
2:失败
sign true 签名 详情见签名规则
异步回调参数示列
{
    "amount": "1",
    "merchantId": "10008",
    "coinType": "USDT_TRC20",
    "bookingAddress": "weqeqweqweqweqw454456",
    "payAddress": "45456qweqweqweqweq",
    "cnyConvertUsdtRate": "7.28",
    "quickState": "1",
    "memberNo": "5456414444",
    "merchantOrderNo": "2023062120200808",
    "orderNo": "20230621202222200808",
    "sign": "aaGJROTtAfLKIJwB/ox/W91NjWiMOTFA3OJHioz7HfbTt+ZRunv1qCxG+oMgoMzOy5BJmEvWzZeRSj4x11EswJVWMX1AhB7QQmCtxax5J4BjggyxnqeukVvm9CwL8+uQY3ouIi0aISRSVUjcgbIWt71KGQf47xs7vt9fy7TIPK0=",
    "status": "1",
    "payCoinAmount": "19.021"
}
回调验证成功后返回参数说明
参数 必选 参数名称 说明
code true 回调验证返回 success 成功 其他都代表失败,会重复回调
merOrderNo fasle 商户单号 回传会修改生成订单的商户单号,不传则不会修改
回调验证成功后返回参数示例
{	
	"code":"success",
	"merOrderNo":"111222333"
}
回调验证失败后返回参数示例
{	
	"code":"fail",
	"merOrderNo":"111222333"
}

13. 商户通道汇率获取

商户通道网关

生产环境: https://gateway.bishengusdt.com/api/merchant/queryChannelRate

支持格式

JSON

HTTP请求方式

POST

请求参数
参数 必选 参数名称 说明
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
coinType true 通道币种 例如:USDT_TRC20,CNY
version true 版本号 6.0.0
sign true 签名 详情见签名规则
请求参数示例
{
    "merchantId": 10058,
    "version": "6.0.0",
    "coinType": "USDT_TRC20",
    "sign": "cdqKNNc7HmQrT7QkcGq6MRfvDpElpgnpdF4dzHh9eu+VdtrhoLeino5vRwnxQXtQhcG0DyXZ2stJ3rTGvwtfOU//j40QeTHFRdnYvLKawCoBVEEGHtzGNfiGgNpMlh+58pVYO8aGQPe+P54BwQtQE8W8qm6NgrHtyA9KHQBcqOs="
}
响应参数説明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功,其他值为失败
msg true 响应信息描述 例:操作成功
merchantId true 商户ID 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。
coinType true 币种类型 coinType=USDT_TRC20
collectionExchangeRate true 代收汇率
paymentExchangeRate true 代付汇率
sign true 签名 详情见签名规则
成功响应参数示例
{
    "code": "0",
    "coinType": "USDT_TRC20",
    "collectionExchangeRate": "7.68",
    "merchantId": "10216",
    "msg": "操作成功",
    "paymentExchangeRate": "7.18",
    "sign": "b1UL0QQQmYSlYH8WwAXqyJ3rdD+AxaFQwW5a5GOhzT7Pv2c9xebMUR7oJlkgNre3G8MwcKATGh71GmrOLbN8jq7ZNs1Dl087zQFdlnNwNQ8qIAc9q5veZaj7b5YmjZt3VKsG7ChCA6sqk3gQ7LrKSqxwF5pg5uOtXu/kkmLzXUM="
  }

14. CNY-API代付下单

代付请求网关

生产环境: https://gateway.bishengusdt.com/api/remitMatchOrder/create

回调IP: 8.217.236.95

支持格式

JSON

HTTP请求方式

POST

请求参数说明
参数 必选 参数名称 说明
merchantId true 商户号 平台给定商户唯一标识
version true 版本号 版本号,固定1.0.0
merchantOrderNo ture 商户订单号
amount true 金额 单位:元
最多支持两位小数,如:100.08
bankCode true 银行编码 详情见银行编码
bankcardAccountNo true 银行卡号
bankcardAccountName true 持卡人姓名
memberNo false 会员id 你方平台会员唯一标识,用于风控
notifyUrl true 通知地址
sign true 签名 详情见签名规则
请求参数示例
{
    "amount":"27",
    "bankCode":"ABC",
    "bankcardAccountName":"测试",
    "bankcardAccountNo":"6289990729793741",
		"memberNo":"hao982093",
    "merchantId":"10117",
    "merchantOrderNo":"test20231101202006",
    "notifyUrl":"http://www.baidu.com",
    "sign":"bmEMCRosAQ1Ary0Q6Z5Qj4CEidZjjFkCH71bdeWNXjLENH5NajerFeoOoeVLeYrx68LUa8GM4yEM4zkARE9f2hELYwMnnm1Y0ZPbOdnAfqCNlmyxrnNaCf+39iPXe7oKs7zmP5mF8hPVZarA8+A8OIOvZeLvTSTfDfBXdbg4Y54=",
    "version":"1.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功 ,其他值为失败
msg true 响应信息描述 例:操作成功
merchantId true 商户号 平台给定商户唯一标识
merchantOrderNo true 商户订单号
orderNo true 平台订单号
amount true 金额 单位:元
status true 订单支付状态 0:处理中
1:成功
2:失败
3:收款待确认
sign true 签名 详情见签名规则
成功响应参数示例
{
	"amount":"27",
	"code":"0",
	"merchantId":"10117",
	"merchantOrderNo":"test20231101202006",
	"msg":"操作成功",
	"orderNo":"DF202311031206121000001",
	"sign":"DIm+QWQFXmZeH8WMmBpRZZEkcX4ZewXW4Y4CSzZFwODOCDQoe1f6WyPpzuS6ZZo41hfPxiNGP5z5hAjOqX8T40yy3VrM6sbNzn24OVndC0BvF6uZB9Cavqhdq9h5ZOUlW0BQyCrrNylE6oVFxOwPG7UcAcYquVr62mynsAofKA8=",
	"status":"0"
}
失败响应参数示例
{
	"code":"7",
	"msg":"订单号已存在"
}

15. CNY-API代付订单查询

代付订单查询网关

生产环境: https://gateway.bishengusdt.com/api/remitMatchOrder/query

支持格式

JSON

HTTP请求方式

POST

请求参数说明
参数 必选 参数名称 说明
merchantId true 商户号 平台给定商户唯一标识
version true 版本号 版本号,固定1.0.0
merchantOrderNo true 商户订单号
submitTime true 订单提交时间 格式:yyyyMMddHHmmss
sign true 签名 详情见签名规则
请求参数示例
{
    "merchantId":"10117",
    "merchantOrderNo":"test20231101202001",
    "sign":"frUgPd5BJDL+gRidoT8AwV0bFMYaE4SLSp1L0PU226fb9BL0YPuq84/B2GQZs0uONM0SdbwgjE7ubnp7XH/vNrQ4wxLLTFvH5sSQB6i1qk+02YcAQAkUelIcswsW3LFQe4Tl0aiLgvL2gbipk4vmye3teDMDyKXxbhbgmfcU9/4=",
    "submitTime":"20231103121535",
    "version":"1.0.0"
}
响应参数说明
参数 必选 参数名称 说明
code true 响应状态码 0为请求成功 ,其他值为失败
msg true 响应信息描述 例:操作成功
merchantId true 商户号
merchantOrderNo true 商户订单号
orderNo true 平台订单号
amount true 金额 单位:元
status true 订单支付状态 0:处理中
1:成功
2:失败
3:收款待确认
sign true 签名 详情见签名规则
响应参数示例
{
	"amount":"100",
	"code":"0",
	"merchantId":"10117",
	"merchantOrderNo":"test20231101202001",
	"msg":"操作成功",
	"orderNo":"DF202311031245221000131",
	"sign":"br5JbcgnvQK64fwvYcT80cH2gH+tVvvPzlvQUpLslIuqF4rUrPeMRH4mYfRZMKabQ7VegHYtqXPrL+FM5SAbGzspYIKgcJCuFgIwRyyow9m1zgCgk+0yUSK3Hx7yU4RgSuvUrZSWXfc+b9896zYlrvu0X7pFGkDQQvIE1tpe0pE=",
	"status":"2"
}

16. CNY-代付异步回调通知

异步回调参数说明
参数 必选 参数名称 说明
merchantOrderNo true 商户订单号
merchantId true 平台给定商户唯一标识 例:10001
amount true 实际支付金额 单位:元
orderNo true 平台订单号
status true 订单支付状态 0:处理中
1:成功
2:失败
3:收款待确认
sign true 签名 详情见签名规则

异步回调参数示列

{
	"amount": "32",
	"merchantId": "10117",
	"merchantOrderNo": "test20231025167001",
	"orderNo": "DF202311031245221000131",
	"sign": "OaWOtOgPAdnMSpAkWWyM+MFPQRnXov8Ffv/5zbUwZDmRkzihCpE9RG9N7X9eu3Z15crtAOy1vua+N8VGNYyfYZ8BGhHPJz0dANvjc70ZXBusVOt+RH4jrc3nWHW8cgGgJstSFlQ1Rvic6pPF3df9gRVZFRPu8QC6yiZsCEw2p9c=",
	"status": "1"
}

回调验证成功后返回 success 字符串
若接收到推送未返回 success ,会按照1s,5s,10s,1m,3m,5m,10m,30m,1h,2h进行通知10次,有可能出现重复推送的情况,开发人员一定要注意重复推送问题;