主题
银行账户入金通知
接口描述
- 银行账户虚拟户入金通知给接入方。
注意事项
- 同样的通知可能会多次发送给接入方系统。接入方系统必须能够正确处理重复的通知。
- 接入方系统对于开启结果通知的内容一定要做签名验证,并校验通知的信息的正确性,防止数据泄露导致出现“假通知”,造成损失。
- 当接入方系统收到甬易的推送通知时,必须输出 SUCCESS ,甬易收到 SUCCESS ,便认为接入方已收到;否则将继续发送通知,以递增的时间间隔再次重发 5 次;时间间隔分别为 5/10/20/40/80秒,总时长 155 秒
- 银行入金通知推送地址同商户入网通知地址
请求方式
- POST
通知参数
| 参数名 | 必选 | 类型 | 最大长度 | 说明 | 示例 |
|---|---|---|---|---|---|
| code | 是 | string | 响应编码 | 00000000 | |
| message | 是 | string | 响应信息 | 成功 | |
| signature | 是 | string | 签名 | ||
| transNonce | 是 | string | 32 | 请求流水号(同入参) | 123456 |
| transDate | 是 | string | 13 | 请求时间,13位时间戳 | 1731406784607 |
| notifyType | 是 | string | 64 | 通知类型 | merchant_bank_money_arrive_notify-商户银行账户入金通知; |
| arriveAmount | 是 | string | 32 | 金额,单位:分 | |
| arriveTime | 是 | string | 32 | 入金时间,格式:yyyy-MM-dd HH:mm:ss | 2025-10-20 16:03:30 |
| bankTransNo | 是 | string | 64 | 银行流水 | XTBJGZ20230803000000020310653 |
| payerAccountName | 是 | string | 64 | 付款方账户名称 | 付款方名称 |
| payerAccountNo | 是 | string | 32 | 付款方账户 | 6288888888888881119 |
| payerBankName | 是 | string | 32 | 付款方银行名称 | 中国银联支付标记 |
| payerBankNo | 是 | string | 32 | 付款方银行行号 | 00010045 |
| merchantNo | 是 | string | 32 | 商户编号 | XS2508xxxxxxx |
| memberBankAccountNo | 是 | string | 32 | 商户银行账户 | 9990021611020200290000271 |
| bankCode | 是 | string | 32 | 银行编码 | |
| remark | 否 | string | 32 | 备注 |
响应报文
SUCCESS