sign算法说明:参数按键值+数值的ASCII编码顺序拼接,生成signData。使用RSA私钥,通过SHA1withRSA算法,RSA加密统一私钥加密,公钥解密。
RSA公私钥可以通过https://www.bejson.com/enc/rsa/ 获取(密钥长度选择1024bit),或者自己生成密钥
amount=100&memberNo=fa521b19e002095b&merchantId=10008&merchantOrderNo=20230630167003&model=821¬ifyUrl=https://www.baidu.com&version=1.0.0
TREA5bSFn62caXvs5PYGslrJdTWdtcE2iyOVzEcl28+YdxnsazP/gJRrfk0eilVtAcpHhvmUisjGQZRQUZewRd9PM33d2AwJ5waStpTPFxjp2H0lvrtPp234aupQBqISxf8PKdBYqBlFZUXtSujTNmKcXGQD0keZOGUE22lCc9Q=
所有非空参数值的参数按照参数名 ASCII 码从小到大排序(字典序),使用URL键值对的格式(即 key1=value1&key2=value2... )拼接成明文字符串后,使用 MD5 加密生成签名串(32位小写)。
例如:sign = md5( key1=value1&key2=value2...&key=商户密钥 )
线上回调IP:
8.217.236.95
- 1.MD5, RSA 获取方式
商户可在"密钥管理"页面获取 MD5 密钥、RSA 公钥/私钥等信息,如下图所示。![]()
- 2.商户请求验签问题(MD5)
- MD5值(秘钥)填写错误
- 参数拼接顺序或填写错误
- signType 未传或传错
- signData示例参数:
amount=10&callbackCurrencyCode=CNY&coinType=CNY&language=en&merchantId=10216&merchantOrderNo=CZ84767069¬ifyUrl=http://www.baidu.com&rate=8&signType=MD5&version=6.0.0- 3. 回调商户验签问题(MD5)
- MD5值(秘钥)填写错误
- 参数拼接顺序或参数填写错误
- 4. 商户请求验签问题(RSA)
- RSA私钥(商户私钥)填写错误(建议到商户后台重新获取)
商户可在"密钥管理"页面获取 RSA 私钥信息,如下图所示。![]()
- 参数拼接顺序或参数填写错误
- 5. 回调商户验签问题(RSA)
- RSA公钥(平台公钥)填写错误(建议到商户后台重新获取)
商户可在"密钥管理"页面获取 RSA 私钥信息,如下图所示。![]()
- 参数拼接顺序或参数填写错误
- 5. RSA 有两对密钥对
- 商户密钥对:
用途:商户提交订单时进行数字签名,确保请求的完整性和来源可信。
签名流程:商户使用商户私钥对订单数据签名,BS 服务器使用商户公钥验签。
注意:商户私钥必须严格保密,防止伪造交易。
- 平台密钥对:
用途:BS 服务器回调商户时进行签名,确保回调数据的真实性。
签名流程:BS 服务器使用平台私钥签名回调数据,商户使用平台公钥验签。
注意:平台公钥需通过商户商户后台秘钥管理获取。
优化提示: 如遇验签失败,建议首先检查密钥是否正确(可到商户后台重新获取),其次核对参数拼接顺序与内容,确保与文档要求一致,并确认 signType 参数是否正确传递。
生产环境: https://gateway.bishengusdt.com/api/coin/payOrder/create
回调IP: 8.217.236.95
JSON
POST
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| merchantId | true | 商户ID | 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。 |
| version | true | 版本号 | 使用最新版本号 6.0.0 |
| merchantOrderNo | true | 商户单号 | 商户创建的订单ID,长度 8~30位 |
| amount | true | 订单金额 |
单位:订单币种 最多支持两位小数,如:100.01 此字段需与 coinType 成对使用:- 当 coinType 为 CNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。- 当 coinType 为 USDT_TRC20 时,amount 即为USDT金额进行代收。
|
| coinType | true | 订单币种 |
代收订单实际支付使用的币种,由币种和地址协议拼接组成, 示例: - coinType=USDT_TRC20- coinType=CNY若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
|
| callbackCurrencyCode | true | 回调币种 |
回调结果中返回的金额单位,如:USDT、CNY- 若 coinType 为 USDT_TRC20,可回调为 USDT或 CNY- 若 coinType 为 CNY,则回调币种通常为 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 | 签名 | 参考签名规则 |
{
"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"
}
{
"amount": "10",
"callbackCurrencyCode": "CNY",
"callbackExchangeRate": "",
"coinType": "CNY",
"memberNo": "",
"merchantId": "10216",
"merchantOrderNo": "CZ69785959",
"notifyUrl": "https://baidu.com",
"sign": "g2vm5m9Ra1VDgWVprNw8b4K9qzntTgbbgpVMUeQt7b2YN4KhLPyIkDoN66eAeouvtQPUlj677dIKbCUabfCiXGXUmFmjWc3IcWyASSQQNR1VIb7lbcMHDPewLr76DMys0epXSKCKndh1Cnssgywjg1MnGoLbG4AvZ3raVNUn7vI=",
"version": "6.0.0"
}
{
"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 | 签名 | 参考签名规则 |
{
"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"
}
{
"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"
}
{
"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":"订单号已存在"
}
生产环境: https://gateway.bishengusdt.com/api/coin/payOrder/createCashier
回调IP: 8.217.236.95
JSON
POST
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| merchantId | true | 商户ID | 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。 |
| version | true | 版本号 | 使用最新版本号 6.0.0 |
| merchantOrderNo | true | 商户单号 | 商户创建的订单ID,长度 8~30位 |
| amount | true | 订单金额 |
单位:订单币种 最多支持两位小数,如:100.01 此字段需与 coinType 成对使用:- 当 coinType 为 CNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。- 当 coinType 为 USDT_TRC20 时,amount 即为USDT金额进行代收。
|
| coinType | true | 订单币种 |
代收订单实际支付使用的币种,由币种和地址协议拼接组成, 示例: - coinType=USDT_TRC20- coinType=CNY若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
|
| callbackCurrencyCode | true | 回调币种 |
回调结果中返回的金额单位,如:USDT、CNY- 若 coinType 为 USDT_TRC20,可回调为 USDT或 CNY- 若 coinType 为 CNY,则回调币种通常为 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 | 签名 | 参考签名规则 |
{
"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"
}
{
"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"
}
{
"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 | 签名 | 参考签名规则 |
{
"msg": "操作成功",
"code": "0",
"exchangeRate": "1",
"sign": "ckCvmdP7m3KDIpkxBq0h6+94MbI7qkntsRXy14q5YwypIkuMR7KqlVwAxeUqYEQ+ZcQPpBnMUVBcaUMRXABpuGE54JPcOE9I+vyQGBWFOd+ZW7/ZsrEJWhzjUMF1Zk1ayVaEYZUc0PDaPsgFTPkA1JA1LwqLfn9JwukbQ6Mr0f0=",
"payUrl": "http://test-upqp.cfbaopay.com/?orderNo=CZ202506242117201065353&language=en"
}
{
"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"
}
{
"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": "订单号已存在"
}
生产环境:https://gateway.bishengusdt.com/api/coin/payOrder/query
JSON
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"
}
生产环境:https://gateway.bishengusdt.com/api/coin/remitOrder/create
回调IP: 8.217.236.95
JSON
POST
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| merchantId | true | 商户ID | 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。 |
| version | true | 版本号 | 使用最新版本号 6.0.0 |
| merchantOrderNo | true | 商户单号 | 商户创建的订单ID,长度 8~30位 |
| amount | true | 订单金额 |
单位:订单币种 最多支持两位小数,如:100.01 此字段需与 coinType 成对使用:- 当 coinType 为 CNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。- 当 coinType 为 USDT_TRC20 时,amount 即为USDT金额进行代收。
|
| coinType | true | 订单币种 |
代收订单实际支付使用的币种,由币种和地址协议拼接组成, 示例: - coinType=USDT_TRC20- coinType=CNY若为 CNY 或其他法币币种,系统将根据当前汇率转换为 USDT_TRC20 金额(U)进行代收。
|
| bookingAddress | true | 收款地址 | 订单币种的接收地址 |
| callbackCurrencyCode | true | 回调币种 |
回调结果中返回的金额单位,如:USDT、CNY- 若 coinType 为 USDT_TRC20,可回调为 USDT或 CNY- 若 coinType 为 CNY,则回调币种通常为 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 | 签名 | 参考签名规则 |
{
"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"
}
{
"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"
}
{
"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 | 签名 | 参考签名规则 |
{
"amount": "10",
"code": "0",
"exchangeRate": "1",
"merchantOrderNo": "DF33816566",
"msg": "操作成功",
"remitCoinAmount": "10.0000",
"sign": "eZMSGpTeIzpggcgUh+bedL0ypJYyzWN95hgiTG3lxyGIS7BtLccb7e1rXYmYTc7ze0InhrSqAdsTZtD0L13jk0IiCpyk2+ucnTxaR90xv5Z3Z/BkWiMPz9odzZo88JGk3McoVVrADWU4vmmzmGLqlT8tsCc877ORaHM3C1pF5fo=",
"status": "0"
}
{
"amount": "1.39",
"code": "0",
"exchangeRate": "1",
"merchantOrderNo": "DF82898135",
"msg": "操作成功",
"remitCoinAmount": "1.3900",
"sign": "KG10yCTr+eKwbsFOzhqiBxpOkS9ifU4wJiXX+RduJaRzinrnB1WpqaCpswP/spQeyfHFdNuA4Nref42/lNVP/po1DreoeWurd8+IDDDXTuu7JYQOZU1yqbfxNMAWWA61jJxMzNiDuMd4KcRVUxNFHK7C7EJR9HIbVEKN5BWvqaQ=",
"status": "0"
}
{
"amount": "1.25",
"code": "0",
"exchangeRate": "1",
"merchantOrderNo": "DF52134284",
"msg": "操作成功",
"remitCoinAmount": "1.2500",
"sign": "KIyltFR9zPJRWmIFEhEx04lYlGdRX1tiModkmDCJG6mWg2riJj0HECEYEv1gvbQYXA0V4IOuXIng6rkaOY0lieuq1/G9i7FRg7rYCsHxvIO+c/5BGpjyEf1pSecfDKATRdpbtLfYW5pHuEGeneNhrB4BPmnCIwOmOEYmBvr9R6c=",
"status": "0"
}
生产环境:https://gateway.bishengusdt.com/api/coin/remitOrder/query
JSON
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"
}
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| merchantOrderNo | true | 商户订单号 | |
| merchantId | true | 商户ID | 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。 |
| amount | true | 应收金额 |
单位:订单币种 最多支持两位小数,如:100.01 此字段需与 coinType 成对使用:- 当 coinType 为 CNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。- 当 coinType 为 USDT_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% 订单金额回调,请注意用真实金额上分!!!
{
"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"
}
{
"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"
}
{
"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"
}
{
"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"
}
{
"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"
}
{
"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"
}
{
"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"
}
{
"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"
}
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| merchantOrderNo | true | 商户订单号 | 商户创建的订单ID,长度 8~30位 |
| merchantId | true | 商户ID | 平台给定商户唯一标识(纯数字,如10070),可通过平台发送的邮件获取,或登录商户后台查看。 |
| exchangeRate | true | 汇率 | |
| amount | true | 订单金额 |
单位:订单币种 最多支持两位小数,如:100.01 此字段需与 coinType 成对使用:- 当 coinType 为 CNY 时,amount 即为法币金额,系统将按汇率转换为 USDT 进行代收。- 当 coinType 为 USDT_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 字符串
{
"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"
}
{
"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"
}
{
"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"
}
{
"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"
}
JSON
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"
}
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| 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="
}
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| merchantOrderNo | true | 商户订单号 | 商户创建的订单ID,长度 8~30位 |
| code | true | 操作状态 | 0: 操作成功 其它值为失败 |
| message | true | 操作描述 | 操作描述 (成功或者失败) |
| sign | true | 签名 | 详情见签名规则 |
生产环境: https://gateway.bishengusdt.com/api/coin/quick/queryAddress
回调IP: 8.217.236.95
JSON
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="
}
| 参数 | 必选 | 参数名称 | 说明 |
|---|---|---|---|
| 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"
}
生产环境: https://gateway.bishengusdt.com/api/merchant/queryChannelRate
JSON
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="
}
生产环境: https://gateway.bishengusdt.com/api/remitMatchOrder/create
回调IP: 8.217.236.95
JSON
POST
参数 必选 参数名称 说明 merchantId true 商户号 平台给定商户唯一标识 version true 版本号 版本号,固定1.0.0 merchantOrderNo ture 商户订单号 amount true 金额 单位:元
最多支持两位小数,如:100.08bankCode 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":"订单号已存在"
}
生产环境: https://gateway.bishengusdt.com/api/remitMatchOrder/query
JSON
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"
}
参数 必选 参数名称 说明 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次,有可能出现重复推送的情况,开发人员一定要注意重复推送问题;