Skip to content

查询退款状态 ​

本接口为回调接口,由 APP 服务端实现并提供给 SUD 调用,SUD 将通过此接口向 APP 服务端查询退款状态。

接口说明 ​

接口英文名 pay.refundQuery

功能描述 查询退款状态。SUD OP SVR 通过此回调接口向 APP 服务端查询指定退款单的处理状态及详情。

注意:本接口强制要求服务通信二次加密和签名:回调请求必须验签通过后才能处理业务,可有效防止数据篡改与泄露。

调用方式 ​

HTTPS 调用 ​

http
POST <APP 自定义回调地址>

请求参数 - Body ​

属性类型默认值必填说明
sud_refund_nostring是SUD 退款单号

返回值 ​

返回的 JSON 数据包

属性类型说明
errcodeint32错误码
errmsgstring错误信息
envnumber环境配置 0-正式环境, 1-测试环境
refund_idstring【退款单号】申请退款受理成功时,该笔退款单在支付侧生成的唯一标识
sud_refund_nostringSUD 退款单号
sud_trade_nostringSUD 业务订单号
statusstring退款单状态,枚举类: REFUNDING-退款处理中,REFUNDED-退款成功,REFUND_FAIL-退款失败。本字段表示退款单自身状态

调用示例 ​

说明:以下请求示例为解密后的业务数据,实际收到的是密文并携带签名请求头,须先验签、解密后再按此结构解析;返回示例为加密前的业务数据,实际返回须先加密、再对密文签名。完整规范见回调签名加密。

请求数据示例 ​

json
{
  "sud_refund_no": "sud_refund_20231024123456"
}

返回数据示例 ​

json
{
  "errcode": 0,
  "errmsg": "ok",
  "env": 0,
  "refund_id": "50300123420231024567890",
  "sud_refund_no": "sud_refund_20231024123456",
  "sud_trade_no": "sud_20231024123456",
  "status": "REFUNDED"
}