回调通知

1. 支付/提现结果后台通知

商户提供 notifyUrl 接口，用于接收支付或提现结果的异步通知。定义好后，登录商户后台-商户中心中配置和测试 注意：商户未及时处理通知或网络波动，可能会对同一个订单重复通知到商户平台，商户请做好接口幂等处理。

1.1 接口信息

• 请求方式: POST
• Content-Type: application/json

1.2 通知参数

参数名称	参数命名	最大长度	类型	必填	备注
平台订单号	orderId	28	Long	Y	平台订单号
链类型	chainType	20	String	Y	TRC20(波场)
外部用户id	extUserId	20	String	Y	外部用户id, 商户提现这个值为空
订单金额	amount	15	String	Y	订单金额（2位小数）
交易币种	currency	4	String	Y	USDT
订单状态	txnStatus	6	String	Y	0-待处理，1-处理中 2-交易完成，3-交易失败，4-取消交易 5-订单过期
通知类型	notifyType	20	String	Y	TOP_UP：充值, WITHDRAWAL：提现
子用户钱包账号地址	customerAddress	64	String	Y	子用户的钱包地址，在子用户充值和提现的时候会传递
订单创建时间	createTime		Long	Y	订单创建时间
商户订单号	mcOrderId		String	Y	建单的时候为空值，建单成功商户返回商户订单号，后续回调将该字段返回
手续费	fee		BigDecimal	Y	手续费
到账金额	amountArrival		BigDecimal	Y	到账金额
交易成功时间	txnTime		Long	Y	时间戳
过期时间	expireTime		Long	Y	时间戳 仅在充值订单过期时存在
签名	sign	32	String	Y	签名方式详见安全规范

1.3 商户响应规范

商户系统接收到异步通知以后，必须通过验签（验证通知中的 sign 参数）来确保支付通知是由我方平台发送的。 接受到异步通知并验签通过后，一定要检查通知内容，包括通知中的 appKey、amount、currenceCode 等是否与请求中的一致，并根据 txnStatus 进行后续业务处理。

响应参数：

参数名称	参数命名	最大长度	类型	必填	备注
业务返回码	code	255	Integer	Y	200为成功，通信成功标识
返回信息	msg		String	N	错误信息

响应示例：

{
    "code": 200,
    "msg": "success"
}