主题
信用分订单通知
接口描述
- 信用分订单在用户确认授权(USER_CONFIRM),用户取消授权(CLOSE),付款成功(FINISH)触发通知。
注意事项
- 同样的通知可能会多次发送给接入方系统。接入方系统必须能够正确处理重复的通知。
- 接入方系统对于开启结果通知的内容一定要做签名验证，并校验通知的信息的正确性，防止数据泄露导致出现“假通知”，造成损失。
- 当接入方系统收到甬易的推送通知时，必须输出 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 |
| outOrderNo | 是 | string | 32 | 接入方订单流水号 | OUT00000001 |
| orderNo | 是 | string | 32 | 支付系统信用分单号 | 1854100814175592449 |
| merchantNo | 是 | string | 32 | 商户号 | XS240820000054 |
| tradeNo | 否 | string | 255 | 扣款交易流水号(订单扣款完成返回) | |
| orderAmount | 是 | string | 20 | 订单金额(单位分) | 100 |
| actualAmount | 否 | string | 20 | 结单金额(单位分) | 100 |
| tradeFee | 否 | string | 20 | 交易手续费(单位分),扣款成功返回 | 1 |
| orderStatus | 是 | string | 32 | 订单状态： INIT:初始(订单已创建),USER_CONFIRM:已确认,COMPLETE:已结单,PENDING_PAYMENT:待支付,CLOSE:关闭,OVERDUE:逾期,FINISH:完成 | FINISH |
| finishTime | 否 | string | 32 | 完成时间(yyyyMMddHHmmss),终态返回 | 202411110858 |
| closeReason | 否 | string | 32 | 订单关闭原因 | 用户取消授权 |
通知报文示例
响应报文
SUCCESS