Skip to content

退款通知

当退款完成时(成功或失败),支付网关会向商户系统发起回调通知。如果商户系统没有正确返回,支付网关会延迟再次通知。

注意

该接口是通过创建订单接口的notifyUrl参数提交的,如果无法访问该接口,商户系统将无法接收到支付系统的通知。

请求说明

  • 请求方式:POST
  • 请求类型:application/json 或者 application/x-www-form-urlencoded

通知参数

名称参数类型必填示例值描述
商户号mchNoStringM1621873433953商户号
应用IDapp_idString60cc09bce4b0f1c0b83761c9应用ID
网站IDapp_idint10010网站ID
退款订单号refund_order_idStringR20160427210604000490支付系统退款订单号
支付订单号pay_order_idStringP12021022311124442600支付系统订单号
商户侧退款订单号mch_refund_noString20160427210604000490商户侧退款订单号
支付金额pay_amountint12000支付金额,单位分
退款金额refund_amountint12000退款金额,单位分
货币代码currencyStringUSD三位币种编码
退款状态stateint2支付订单状态
0-订单生成
1-退款中
2-退款成功
3-退款失败
4-退款关闭
扩展参数ext_paramString134586944573118714商户扩展参数
退款成功时间success_timelong1622016572190退款成功时间
创建时间created_atlong1622016572190订单创建时间
通知请求时间req_timelong1622016572190通知请求时间
渠道错误码err_codeString1002渠道返回错误码
渠道错误描述err_msgString1002渠道返回错误描述
签名signStringC380BEC2BFD727A4B6845133519F3AD6签名值

通知返回

业务系统处理后同步返回给支付平台。

返回格式:Stringsuccess表示成功,其他字符串表示失败。

说明

如果返回的字符串不是success,支付平台会认为通知失败,并进行重试。
通知重试间隔时间为0/30/60/90/120/150,单位:秒。