充值回调

会员发起充值后，我方将充值结果通知接入方。

注意： 1.二维码充值（外部创建充值订单）：rate、fiat、fiatAmount、status、refOrderId 存在返回值；返回为空的字段也需要加入签名串验证，比如：非法币二维码充值，返回的 fiat为""也需验证

2.充值回调订单一定是成功订单，接入方无需判断status。

3.网络请求可能会因为各种原因（如超时、网络波动等）发生重复，导致系统状态出现异常或数据不一致。 接入方需要根据相关参数做 幂等校验，重复数据返回code为0

4.充值回调接入方需判断 code(代币 usdt、trx) ，因为地址是可以充值其他代币的

5.接口可能增加字段，验证签名时必须支持增加的扩展字段

• 请求路径

URL	request	version	Content-Type
[接入方充值回调地址]	POST	1.0	application/json

• 回调参数

请求参数	类型	必填	参数说明	示例
hash	String	true	交易hash	xxxxxxxx
chainCode	String	true	网络(链)	tron 、eth、bnb等
code	String	true	币种	trx、usdt等
sourceAddress	String	true	打款地址	xxxxxxxxxxxx
targetAddress	String	true	收款地址	xxxxxxxx
amount	decimal	true	充值金额	0.01
clientId	String	true	业务方用户id	908736451
risk	Boolean	false	风险检测结果，需开风险检测。true 风险， false 非风险，未开启默认false	false
sign	String	true	签名	JOqrp8E1ydx
rate	decimal	false	汇率	7.28
fiat	String	false	法币币种	CNY
fiatAmount	decimal	false	法币金额	728
status	Integer	false	订单状态 1.成功 2.失败	1
refOrderId	String	false	业务方订单id	SN2024121205123

• 返回

返回参数	参数类型	必返回	参数说明
code	String	true	"0"- 表示成功，失败会有message信息
message	String	false	失败message信息

• 回调签名样例顺序（rsa 生成签名原始内容）

二维码充值成功（预下单）

amount=1&chainCode=tron&clientId=676630e4a&code=trx&fiat=CNY&fiatAmount=7280&hash=37407c9a2a44e3c76f843256466d0364993630001b1187962a1fd7d7a3c2ee6b&rate=7.28&refOrderId=SN2024020202010212311&risk=false&sourceAddress=TCm71Fe3vdDKfittRcRraJXwrHVAvHGtkw&status=1&targetAddress=TYkXe2ga3AQNra4zL7RUei3hHYEq11dEva

正常充值（非预下单）

amount=0.1&chainCode=tron&clientId=flaod12341111111&code=trx&hash=d00cd8fc4cba5b95892bb6aaa9ea1bad6755cabab0bbbb5f548f566cfa93a95b&risk=false&sourceAddress=TRxukGAMqz8kjeerLTh4ADe9j5EinbFfeT&targetAddress=TYhfHCBtmE6Mx8mKa3GsVcikCwAhSAfTcH

• 回调参数

二维码成功回调：
{
	"amount": 1,
	"chainCode": "tron",
	"clientId": "676630e4a",
	"code": "trx",
	"fiat": "CNY",
	"fiatAmount": 7280,
	"hash": "37407c9a2a44e3c76f843256466d0364993630001b1187962a1fd7d7a3c2ee6b",
	"rate": 7.28,
	"refOrderId": "SN2024020202010212311",
	"risk": false,
	"sign": "b0+eAsprJBwoJCyIu0iZPiOmdnzyp+FyIWED29dDFMBk3Yt0mZ3Oi9PJvbMcWz1haoH4tXQElfasOEtXJEEQn35D8OZoLl+qV0DyGGRgYqmm9VeEoB6QKvJ/iEmZZR/zngk9AbHlcxdGnxJRkdgxx7DWiDEHNSMQ1hZUXSMXEC3BcLXkLiB0eYvtY7Y3ExcuZl3+CnlpBezw/mxGTARqj0Au3+qi0Tj5wn88Py1qbYh6KZhEjnF1fKtW46V3cMmb2J/GaeOAzk9mpsWW12TBO+qM6Vq6yLJ7MogvlC6zfdzfQMcX5ssev4QJK7zPdfHShvXxPwM3nQ52dbiQtTosCQ==",
	"sourceAddress": "TCm71Fe3vdDKfittRcRraJXwrHVAvHGtkw",
	"status": 1,
	"targetAddress": "TYkXe2ga3AQNra4zL7RUei3hHYEq11dEva"
}

正常充值（非预下单）回调：
{
	"amount": 0.1,
	"chainCode": "tron",
	"clientId": "flaod12341111111",
	"code": "trx",
	"hash": "d00cd8fc4cba5b95892bb6aaa9ea1bad6755cabab0bbbb5f548f566cfa93a95b",
	"risk": false,
	"sign": "Vv6aql2Yr3LPIcRigrgXVIeWEhg9uDyY4S/pM9KQGQ9kM/0eBu8t5Nd3tcNA88bK4wpK87gStdy0r1qfAEINqJoDB6jMPKrBFVfzIvrxOxES40Vq9anQH1eGyVf9s4IU1V10e5Qnx5ipgpTpn1GJfuyYFOe4neY7aldpO7oybQwZ+JGxEj7CdUcAZ2jrK04/OOAoPcVY7UlkkDcs6LqMVHUt8Xc2pOflUKt6eiwpCxzLU3H1Tneaav0y4ml0PKzkmKlZvqnN+dWlp/FO57ALBxFU/t5sn+N/kXdnnm4i9xYq0G/Tamy6Tykk6JTZGRr7aTzaEKGcygPMTMfZzzn0CA==",
	"sourceAddress": "TRxukGAMqz8kjeerLTh4ADe9j5EinbFfeT",
	"targetAddress": "TYhfHCBtmE6Mx8mKa3GsVcikCwAhSAfTcH"
}

• 返回

{
  "code": "0",
  "message": ""
}