主题
商户批量转账结果通知
接口描述
- 商户批量转账申请处理完成后会将处理结果通知给接入方。
注意事项
- 同样的通知可能会多次发送给接入方系统。接入方系统必须能够正确处理重复的通知。
- 接入方系统对于开启结果通知的内容一定要做签名验证,并校验通知的信息的正确性,防止数据泄露导致出现“假通知”,造成损失。
- 当接入方系统收到甬易的推送通知时,必须输出 SUCCESS ,甬易收到 SUCCESS ,便认为接入方已收到;否则将继续发送通知,以递增的时间间隔再次重发 5 次;时间间隔分别为 24s,1m,1m,6m,12m。
请求方式
- POST
通知参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间,13位时间戳 | 1731406784607 |
| batchNo | 是 | string | 32 | 批次号 | 35202507211947148083969847297 |
| detail | 是 | array | 转账明细 | ||
| -outTransferNo | 是 | string | 商户申请单号 | T2025072112130123 | |
| -transferNo | 是 | string | 平台单号 | 35202507211947148083969847298 | |
| -orderStatus | 是 | string | 订单状态,INIT:初始,TRANSFERING:转账处理中,SUCCESS:成功,CLOSE:关闭 | SUCCESS | |
| -respCode | 是 | string | 返回编码 | ||
| -respMsg | 是 | string | 返回信息 | ||
| -transferAmount | 是 | string | 转账金额,单位:分 | ||
| -transferFee | 是 | string | 转账手续费,单位:分 | ||
| -finishTime | 是 | string | 完成时间,格式:yyyyMMddHHmmss | 20250721121416 |
异步通知示例
json
{"batchNo":"35202507211947148083969847297",
"code":"00000000",
"detail":[{"finishTime":"20250721121416","orderStatus":"SUCCESS","outTransferNo":"T2025072112130123","respCode":"S0001","respMsg":"success","transferAmount":"100","transferFee":"0","transferNo":"35202507211947148083969847298"}],"message":"成功","signature":"dYvzsy1JjEJnwAUzCVzdjHapip8IkbXhueDuOQ6PlvTn7Ba3SO55uK9mnxWU7csAfDqeTp09BppkFStxk0tfxbxjlMrmp5/hjPglvS1VMmEoYI8SiTvFe41gleZQApCoaQx3IriAWnKJjyNr8IMFNLdL7BJ6VeLrPgNLtQN3axUATapr8fSW32hbVs2FjtXxcUWdFbVpYGzr6BP6lBjwtb6WENCVcS7g15aOres0TXH2rm34QQhf8ggfOyCgl1k2iWSIm2iPywvmEZxwCXCSQgPuXTqmv5/b9vid87/xim0nCLN9EjEdt6N9GRb6yG50nAHEwQf9HbPGatzyqXH+Xg==","transNonce":"48cb200b33684da884d458b86c4ab1c1"}响应报文
SUCCESS