退款通知
当退款完成时(成功或失败),支付网关会向商户系统发起回调通知。如果商户系统没有正确返回,支付网关会延迟再次通知。
注意
该接口是通过创建订单接口的notifyUrl参数提交的,如果无法访问该接口,商户系统将无法接收到支付系统的通知。
请求说明
- 请求方式:
POST - 请求类型:
application/json或者application/x-www-form-urlencoded
通知参数
| 名称 | 参数 | 类型 | 必填 | 示例值 | 描述 |
|---|---|---|---|---|---|
| 商户号 | mchNo | String | 是 | M1621873433953 | 商户号 |
| 应用ID | app_id | String | 是 | 60cc09bce4b0f1c0b83761c9 | 应用ID |
| 网站ID | app_id | int | 是 | 10010 | 网站ID |
| 退款订单号 | refund_order_id | String | 是 | R20160427210604000490 | 支付系统退款订单号 |
| 支付订单号 | pay_order_id | String | 是 | P12021022311124442600 | 支付系统订单号 |
| 商户侧退款订单号 | mch_refund_no | String | 是 | 20160427210604000490 | 商户侧退款订单号 |
| 支付金额 | pay_amount | int | 是 | 12000 | 支付金额,单位分 |
| 退款金额 | refund_amount | int | 是 | 12000 | 退款金额,单位分 |
| 货币代码 | currency | String | 是 | USD | 三位币种编码 |
| 退款状态 | state | int | 是 | 2 | 支付订单状态 0-订单生成 1-退款中 2-退款成功 3-退款失败 4-退款关闭 |
| 扩展参数 | ext_param | String | 否 | 134586944573118714 | 商户扩展参数 |
| 退款成功时间 | success_time | long | 否 | 1622016572190 | 退款成功时间 |
| 创建时间 | created_at | long | 是 | 1622016572190 | 订单创建时间 |
| 通知请求时间 | req_time | long | 是 | 1622016572190 | 通知请求时间 |
| 渠道错误码 | err_code | String | 否 | 1002 | 渠道返回错误码 |
| 渠道错误描述 | err_msg | String | 否 | 1002 | 渠道返回错误描述 |
| 签名 | sign | String | 是 | C380BEC2BFD727A4B6845133519F3AD6 | 签名值 |
通知返回
业务系统处理后同步返回给支付平台。
返回格式:
String,success表示成功,其他字符串表示失败。
说明
如果返回的字符串不是success,支付平台会认为通知失败,并进行重试。
通知重试间隔时间为0/30/60/90/120/150,单位:秒。