BS-支付文档2.0

签名规则

USDT代收（接口模式）

USDT代收（收银台模式）

USDT代收订单查询

USDT代付下单

USDT代付订单查询

代收回调通知

代付回调通知

余额查询

API代付反查请求

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

闪付支付结果通知

商户通道汇率获取

CNY-API代付下单

CNY-API代付订单查询

CNY-代付异步回调通知

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

2. USDT代收（接口模式）

代收下单网关

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

回调IP: 8.217.236.95

支持格式

JSON

http请求方式

POST

请求参数

参数必选参数名称说明

merchantId true 商户ID 平台给定商户唯一标识

version true 版本号版本号，固定2.0.0，3.0.0（仅回调参数不同）5.0.0

merchantOrderNo true 商户单号商户创建的订单ID

amount true 订单金额单位：订单币种
最多支持两位小数，如：100.01

coinType true 订单币种代收订单实际支付的订单币种，由币种和地址协议拼接组成，如：USDT_TRC20，USDT_BEP20，CNY（如果使用CNY那么则会按照汇率转换为U进行代收）

callbackCurrencyCode true 回调币种回调结果的，返回订单数量的单位；如：CNY、USDT，注：coinType为USDT_TRC20,USDT_BEP20对应callbackCurrencyCode为CNY、USDT

callbackExchangeRate false 回调订单汇率回调金额计算使用的汇率，不传时，使用系统汇率

memberNo false 商户会员号

notifyUrl true 通知地址订单成功后的回调通知地址

signType false 加密方式 RSA,MD5 （默认RSA）

sign true 签名参考签名规则

请求参数示例

 {
 	"amount": "100",
 	"callbackCurrencyCode": "CNY",
 	"coinType": "USDT_TRC20",
	"memberNo": "",
	"merchantId": "10008",
	"callbackExchangeRate": "",
	"merchantOrderNo": "20230630167005",
 	"notifyUrl": "https://www.baidu.com",
 	"sign": "V6k+ZekXkJuDHiYEAAjyD4rP2+DxqKNHOk5XWfRVL6i5psTy/otAybLc87Sev6YNWyDjHPvgU+fAXT2H+7jJJmD5ZzzyCIRUBL18WZ/+7sADEThGQAQouJcxFU5i1jAMvkcnxJvaqBJTZ7Xzl7TsvntO2OrODfgjnrvz/SqBvY8=",
	"version": "2.0.0"
 }

响应参数说明

参数必选参数名称说明

code true 响应状态码 0为请求成功，其他值为失败

msg true 响应信息描述例：操作成功

merchantOrderNo true 商户单号商户创建的订单ID

coinType true 订单币种代收订单实际支付的订单币种，由币种和地址协议拼接组成，如：USDT_TRC20,USDT_BEP20

payCoinAmount true 实际支付金额订单实际支付的金额，单位：订单币种

bookingAddress true 收款地址订单币种的接收地址

exchangeRate true 订单汇率回调金额根据回调币种计算

orderNo true 平台单号平台创建的订单ID

orderExpireDate true 订单过期时间订单支付有效时间，超时请勿转入

callbackCurrencyCode true 回调币种回调结果的，返回订单数量的单位；如：CNY、USDT

sign true 签名参考签名规则

成功响应参数示例

{
	"payCoinAmount":"100",
	"code":"0",
	"merchantOrderNo":"20230630167005",
	"orderNo":"CZ20230630167005",
	"msg":"操作成功",
	"coinType":"USDT_TRC20",
	"bookingAddress":"TPHWprt9oCAW5Kaia3enbYcz4idJY6oyTj",
	"exchangeRate":"7.38",
	"orderExpireDate":"2023-09-26 14:03:14",
	"callbackCurrencyCode":"CNY",
	"sign":"gjhCG6sAJQzAcfeRCY8oe56fD1cTmGGmLlbbiOfFkx4cGuToCFEcU5RWz4oiZPevYfNqAZCmLRma3B6SkAijizwwIHFsa3hbiUGMAHQC0VXowdW5Z5+nZhLv2ekQPZVX8xKMhi6qejhmDLgdkKOqqJiEMcBMXXHRrrTRXzO+F1c="
}

失败响应参数示例

{
	"code":"7",
	"msg":"订单号已存在"
}

3. USDT代收（收银台模式）

代收下单网关

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

回调IP: 8.217.236.95

支持格式

JSON

http请求方式

POST

请求参数

参数	必选	参数名称	说明
merchantId	true	商户ID	平台给定商户唯一标识
version	true	版本号	版本号，固定2.0.0，3.0.0（仅回调参数不同），4.0.0（添加多语言模式）5.0.0
merchantOrderNo	true	商户单号	商户创建的订单ID
amount	true	订单金额	单位：订单币种最多支持两位小数，如：100.01
coinType	true	订单币种	代收订单实际支付的订单币种，由币种和地址协议拼接组成，如：USDT_TRC20,USDT_BEP20，CNY（如果使用CNY那么则会按照汇率转换为U进行代收）
callbackCurrencyCode	true	回调币种	回调结果的，返回订单数量的单位；如：CNY、USDT，注：coinType为USDT_TRC20,USDT_BEP20对应callbackCurrencyCode为CNY、USDT
callbackExchangeRate	false	回调订单汇率	回调金额计算使用的汇率，不传时，使用系统汇率
memberNo	false	商户会员号
returnUrl	false	订单成功之后收银台跳转地址
notifyUrl	true	通知地址	订单成功后的回调通知地址
language	true	收银台语言（仅支持4.0.0以上版本）	en（英语）， hi（印地语），jp（日语），phl（菲律宾语），pt_br（葡萄牙语_巴西），th（泰语），zh（中文简体），eg（埃及阿拉伯语），vn（越南语言）
signType	false	加密方式	RSA,MD5 （默认RSA）
sign	true	签名	参考签名规则

请求参数示例

{

"amount": "100",

"callbackCurrencyCode": "CNY",

"currencyCode": "CNY",

"coinType": "USDT_TRC20",

"merchantId": "10008",

"merchantOrderNo": "20230630167005",

"notifyUrl": "https://www.baidu.com",

"sign": "V6k+ZekXkJuDHiYEAAjyD4rP2+DxqKNHOk5XWfRVL6i5psTy/otAybLc87Sev6YNWyDjHPvgU+fAXT2H+7jJJmD5ZzzyCIRUBL18WZ/+7sADEThGQAQouJcxFU5i1jAMvkcnxJvaqBJTZ7Xzl7TsvntO2OrODfgjnrvz/SqBvY8=",

"version": "2.0.0"

}

响应参数说明

参数	必选	参数名称	说明
code	true	响应状态码	0为请求成功，其他值为失败
msg	true	响应信息描述	例：操作成功
payUrl	true	收银台URL
exchangeRate	true	订单汇率
sign	true	签名	参考签名规则

成功响应参数示例

{

"code":"0",

"msg":"操作成功",

"sign":"gjhCG6sAJQzAcfeRCY8oe56fD1cTmGGmLlbbiOfFkx4cGuToCFEcU5RWz4oiZPevYfNqAZCmLRma3B6SkAijizwwIHFsa3hbiUGMAHQC0VXowdW5Z5+nZhLv2ekQPZVX8xKMhi6qejhmDLgdkKOqqJiEMcBMXXHRrrTRXzO+F1c=",

"payUrl":"https://xxxx/api/payOrder/jump/CZ202307020127481000239"

}

失败响应参数示例

{

"code":"7",

"msg":"订单号已存在"
}

4. USDT代收订单查询

代收查询网关

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

支持格式

JSON

http请求方式

POST

请求参数说明

参数	必选	参数名称	说明
merchantId	true	商户ID	平台给定商户唯一标识
version	true	版本号	版本号，固定2.0.0
merchantOrderNo	true	商户单号	商户创建的订单ID
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": "2.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":"USDT_TRC20",

"callbackOrderAmount":"10",

"merchantId":"10011",

"callbackCurrencyCode":"CNY",

"callbackOrderAmount":"70",

"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	平台给定商户唯一标识
version	true	版本号	版本号，固定2.0.0
merchantOrderNo	true	商户单号	商户创建的订单ID
amount	true	订单金额	单位：订单币种最多支持两位小数，如：100.01
coinType	true	订单币种	代付订单实际支付的订单币种，由币种和地址协议拼接组成，如：USDT_TRC20，USDT_BEP20
bookingAddress	true	收款地址	订单币种的接收地址
callbackCurrencyCode	true	回调币种	回调结果的，返回订单数量的单位；如：CNY、USDT，注：coinType为USDT_TRC20，USDT_BEP20对应callbackCurrencyCode为CNY、USDT
callbackExchangeRate	false	回调订单汇率	回调金额计算使用的汇率，不传时，使用系统汇率
notifyUrl	true	通知地址
memberNo	false	商户会员号
signType	false	加密方式	RSA,MD5 （默认RSA）
sign	true	签名	参考签名规则

请求参数示例

{

"amount": "100",

"coinType": "USDT_TRC20",

"bookingAddress": "TPHWprt9oCAW5Kaia3enbYcz4idJY6oyTj",

"merchantId": "80008",

"callbackCurrencyCode": "CNY",

"callbackExchangeRate": "7.73",

"merchantOrderNo": "20230630202003",

"notifyUrl": "http://www.baidu.com",

"sign": "kqzun1v2Iw1nAr9bYzKsRuwKupKXppwNFVW34sLqCD7GmuXAaw1jvcXqBhDD9camhdt/1Yq1D7AyDWDOg60DHAigrbULuek+ZlwiRRiFJOVZTbJRnkewmfDXCVbPOfIGf0NTFjxcJqabL/5SKngwDEGav65+NlJhtgHGfo5UvoI=",
"version": "2.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":"100",

"code":"0",

"status": "1",

"exchangeRate": "7.4",

"remitCoinAmount": "10",

"merchantOrderNo":"20230630202003",

"msg":"操作成功",

"sign":"VFd73ec2XQxfbTLWA/X2wPlbNr77A6ayqtKDYFW9A+P9sw1t93Xn9Wo3XviIqV//frUW+c9ROS7jHl1SlMLcWM+H8EWrvUjntaQI/wIaH12udiO4mf4Akv5gX+jXgbE9ESP9pSnuQO/+f8V16Hg0tves4TfUMVlGNg7XOasfYAk=",

"status":"0"

}

6. USDT代付订单查询

代付订单查询网关

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

支持格式

JSON

http请求方式

POST

请求参数说明

参数	必选	参数名称	说明
merchantId	true	商户ID	平台给定商户唯一标识
version	true	版本号	版本号，固定2.0.0
merchantOrderNo	true	商户单号	商户创建的订单ID
submitTime	true	订单提交时间	格式：yyyyMMddHHmmss (不要求强一致，偏差前后一小时以内，建议传订单创建时间)
signType	false	加密方式	RSA,MD5 （默认RSA）
sign	true	签名	参考签名规则

请求参数示例

{

"merchantId": "80008",

"merchantOrderNo": "20230630202005",

"sign": "rPUnsBJMxBNJRH5WBWY7XSy4CTLcu3uOCjOiQ+WYiSanKH6aQvmHF0vLdq+0bvwzVmekWnR3hmvIvfPzYrE1lbC4bxnEm2mc+/7CanV7RN0jOcQnYGhbEIQEAFfW6gOFJJdH47QegCwuYcZvBaxKUotZK9/3VQHCyOKsLmsIo7A=",

"submitTime": "20230702014551",

"version": "2.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":"100",

"code":"0",

"currencyCode": "CNY",

"merchantOrderNo":"20230630202005",

"msg":"操作成功",

"sign":"gzsyP6fPTS743o3OfOR2SphcE1dGai2kgTBqm9xRifs13NpGB/UiuaeZIl6avF0pA7lP7oC7QMSOlVVY7IFd20/RgvIg3qbLnNR9ffemLEgNPiwdVnb0vBILWrhYkpnXo8qIRsrLSnA5ikGDVGfMNw9BjLSg1jwFAu3MrJs9FEw=",

"status":"0"

}

7. 代收回调通知

参数	必选	参数名称	说明
merchantOrderNo	true	商户订单号
merchantId	true	平台给定商户唯一标识	例：10001
amount	true	应收金额	单位：订单币种
coinType	true	订单币种	代付订单实际支付的订单币种，由币种和地址协议拼接组成，如：USDT_TRC20,USDT_BEP20
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	法币订单金额	仅支持3.0.0以上版本
addFundsCoinAmount	false	实际加款金额	如果不是成功那么则是0，版本5.0.0才有此字段

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

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

8. 代付回调通知

参数	必选	参数名称	说明
merchantOrderNo	true	商户订单号
merchantId	true	平台给定商户唯一标识	例：10001
exchangeRate	true	汇率
amount	true	订单金额	单位：订单币种
coinType	true	订单币种	代付订单实际支付的订单币种，由币种和地址协议拼接组成，如：USDT_TRC20,USDT_BEP20
remitCoinAmount	true	实际出币数量	单位：订单币种最多支持两位小数，如：100.01
callbackCurrencyCode	true	回调币种
callbackOrderAmount	true	回调金额	单位：回调币种（如果用CNY计算，以callbackOrderAmount回调金额上分。）
status	true	订单支付状态	0：处理中，1：成功，2：失败
sign	true	签名	参考签名规则

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

9. 余额查询

余额查询网关

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

支持格式

JSON

http请求方式

POST

请求参数说明

参数	必选	参数名称	说明
merchantId	true	商户ID	平台给定商户唯一标识
version	true	版本号	版本号，固定2.0.0
requestTime	true	请求时间	格式：yyyyMMddHHmmss (不要求强一致，偏差前后一小时以内）
coinType	true	币种	如：USDT
sign	true	签名	参考签名规则

请求参数示例

{
	"merchantId": "80008",
	"coinType": "USDT",
	"requestTime": "20230702014951",
	"sign": "lz9pKC1HofY8hjuvFZgH4xTw3+exKY/CB5CAwGNeNJdWJesi3Bm6RHieQ8iDhfv6CfvbAQusH2zfg1OPAEBDddwow//ZTVWFw5xvs4tv8gCv23rsfTHDiUNE0qUKHspaYrqYFwxua197U4ylOo3D8gI1D6/8pKzez08ZNU32cz0=",
	"version": "1.0.0"
}

响应参数说明

参数	必选	参数名称	说明
code	true	响应状态码	0为请求成功，其他值为失败
msg	true	响应信息描述	例：操作成功
availableAmount	true	可用金额	单位：币种单位
frozenAmount	true	冻结金额	单位：币种单位
unsettledAmount	true	待结算金额	单位：币种单位
sign	true	签名	参考签名规则

10. API代付反查请求

反查参数说明（需要商户提供对外反查api给我方，我方按照下列参数格式反查订单）

参数必选参数名称说明

merchantOrderNo true 商户订单号商户订单id

amount true 金额单位：元

merchantId true 商户id 平台给定商户唯一标识

coinType true 订单币种，链 USDT_TRC20,USDT_BEP20

bookingAddress true 入账地址订单币种链上地址

sign true 签名详情见签名规则

参数	必选	参数名称	说明
merchantOrderNo	true	商户订单号	商户订单id
amount	true	金额	单位：元
merchantId	true	商户id	平台给定商户唯一标识
coinType	true	订单币种，链	USDT_TRC20,USDT_BEP20
bookingAddress	true	入账地址	订单币种链上地址
sign	true	签名	详情见签名规则

反查参数示例

{
    "amount":"100",
    "bookingAddress":"TPHWprt9oCAW5Kaia3enbYcz4idJY6oyTj",
    "coinType":"USDT_TRC20",
    "merchantId":"10008",
    "merchantOrderNo":"2023062120200807",
    "sign":"F+lWyTBkuCDtgKJmoBLHYvoIBYMCHvp7kCK7a9sg8ld8oi+M+dS5QnMhQeYohBribWiHpsu9BwI8QPhxj0b3K6Z8oWhRGDqwRdk3qk8rk2dpfzp+8/h/PB4yCchW1sd8JZUuvFdoBz9ASr3S7MHd0qXVvCQV5CUtlCdtpgsA3i0="
}

响应参数说明参数说明（由商户按这个参数形式制定响应，由code字段跟message字段描述订单反查是否成功）

参数必选参数名称说明

merchantOrderNo true 商户订单号

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 平台给定商户唯一标识

version true 版本号版本号，固定1.0.0

memberNo ture 用户唯一标识

coinType true 币种 USDT_TRC20

sign true 签名详情见签名规则

参数	必选	参数名称	说明
merchantId	true	商户id	平台给定商户唯一标识
version	true	版本号	版本号，固定1.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	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 平台给定商户唯一标识例：10001

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 签名详情见签名规则

参数	必选	参数名称	说明
merchantOrderNo	true	商户订单号，平台自动生成
orderNo	true	平台订单号，平台自动生成
merchantId	true	平台给定商户唯一标识	例：10001
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	true	回调验证返回	success 成功其他都代表失败，会重复回调
merOrderNo	fasle	商户单号	回传会修改生成订单的商户单号，不传则不会修改

回调验证成功后返回参数示例

{	
	"code":"success",
	"merOrderNo":"111222333"
}

回调验证失败后返回参数示例

{	
	"code":"fail",
	"merOrderNo":"111222333"
}

14. 商户通道汇率获取

商户通道网关

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

支持格式

JSON

HTTP请求方式

POST

请求参数

参数必选参数名称说明

merchantId true 商户号平台给定商户唯一标识

coinType true 通道币种例如：USDT_TRC20,USDT_BEP20

version true 版本号版本号，固定1.0.0

sign true 签名详情见签名规则

参数	必选	参数名称	说明
merchantId	true	商户号	平台给定商户唯一标识
coinType	true	通道币种	例如：USDT_TRC20,USDT_BEP20
version	true	版本号	版本号，固定1.0.0
sign	true	签名	详情见签名规则

请求参数示例

{
    "merchantId": 10058,
    "version": "1.0.0",
    "coinType": "USDT_TRC20",
    "sign": "cdqKNNc7HmQrT7QkcGq6MRfvDpElpgnpdF4dzHh9eu+VdtrhoLeino5vRwnxQXtQhcG0DyXZ2stJ3rTGvwtfOU//j40QeTHFRdnYvLKawCoBVEEGHtzGNfiGgNpMlh+58pVYO8aGQPe+P54BwQtQE8W8qm6NgrHtyA9KHQBcqOs="
}

响应参数説明

参数必选参数名称说明

code true 响应状态码 0为请求成功，其他值为失败

msg true 响应信息描述例：操作成功

merchantId true 商户号平台给定商户唯一标识

coinType true 币种类型

collectionExchangeRate true 代收汇率

paymentExchangeRate true 代付汇率

sign true 签名详情见签名规则

成功响应参数示例

{
    "code": "0",
    "coinType": "USDT_TRC20",
    "collectionExchangeRate": "7.34",
    "merchantId": "10058",
    "msg": "操作成功",
    "paymentExchangeRate": "7.34",
    "sign": "XiawSaSpPT8w0TrASiVeLFVZtGt6ROK+mUdU7w6YzfnUQynRqzj3F3uH58Ts2MvpujwHd9yp/HNHXJO91CbuaCzQ8aOAtWOdRScZyLvemzXVChsQcNmIO14Sk0qDSL14bWNEQXrkMPvIZ2x1ZzegtJ7XN0NZxtzQq5jS+z0sCSw="
}

15. 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 签名详情见签名规则

参数	必选	参数名称	说明
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":"订单号已存在"
}

16. 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	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"
}

17. 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次，有可能出现重复推送的情况，开发人员一定要注意重复推送问题；

1. 签名规则

RSA签名规则说明

signData示列

RSA私钥加密signData示列

MD5签名规则说明

回调IP

2. USDT代收（接口模式）

代收下单网关

支持格式

http请求方式

请求参数

请求参数示例

响应参数说明

成功响应参数示例

失败响应参数示例

3. USDT代收（收银台模式）

代收下单网关

支持格式

http请求方式

请求参数

请求参数示例

响应参数说明

成功响应参数示例

失败响应参数示例

4. USDT代收订单查询

代收查询网关

支持格式

http请求方式

请求参数说明

请求参数示例

响应参数说明

响应参数示例

5. USDT代付下单

代付请求网关

支持格式

http请求方式

请求参数说明

请求参数示例

响应参数说明

响应参数示例

6. USDT代付订单查询

代付订单查询网关

支持格式

http请求方式

请求参数说明

请求参数示例

响应参数说明

响应参数示例

7. 代收回调通知

8. 代付回调通知

9. 余额查询

余额查询网关

支持格式

http请求方式

请求参数说明

请求参数示例

响应参数说明

10. API代付反查请求

反查参数说明 （需要商户提供对外反查api给我方，我方按照下列参数格式反查订单）

反查参数示例

响应参数说明参数说明 （由商户按这个参数形式制定响应，由code字段跟message字段描述订单反查是否成功）

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

余额查询网关

支持格式

HTTP请求方式

请求参数说明

请求参数示例

响应参数说明

响应参数示例

12. 闪付支付结果通知

异步回调参数说明 （闪付支付结果通知）

异步回调参数示列

回调验证成功后返回参数说明

回调验证成功后返回参数示例

回调验证失败后返回参数示例

14. 商户通道汇率获取

商户通道网关

支持格式

HTTP请求方式

请求参数

反查参数说明（需要商户提供对外反查api给我方，我方按照下列参数格式反查订单）

响应参数说明参数说明（由商户按这个参数形式制定响应，由code字段跟message字段描述订单反查是否成功）

异步回调参数说明（闪付支付结果通知）