目录

通过sysRefundOrderNo查询退款订单信息

功能介绍

开发者可以调用该接口查询某笔退款订单详细信息。

resultCode返回“000000”表示查询退款订单成功，不代表退款成功，退款状态需根据refundOrderStatus字段判断。

退款订单状态：

  • REFUND_CHL_PROC：处理中

  • REFUND_SUCCESS：成功

  • REFUND_FAILED：失败

场景描述

该接口支持所有的华为支付退款订单查询，若开发者已有申请退款的订单，可以通过该接口查看具体退款订单的退款状态。

接口原型

请求参数

Request Header

参数 是否必选 参数类型 描述
Content-Type 是 String 取值为：application/json; charset=UTF-8
PayMercAuth 是 String 取值为：PayMercAuth的JSON字符串

Request Path

参数 是否必选 参数类型 描述
sysRefundOrderNo 是 String 华为支付的退款订单号。

请求示例

GET /api/v1/partner/aggr/transactions/refunds/orders/{sysRefundOrderNo} HTTP/1.1
Content-Type: application/json;charset=UTF-8
PayMercAuth: {"callerId":"10132120***","traceId":"202305151501075707669","time":1684134067480,"authId":"120291744647139***","headerSign":"p9e6EvvWnVW/QfTA41SgWba4MmRjn5kNUY+9******************75/UrhP0aBflpW1J8Sf8VUt6orCWk=","bodySign":"haZnDZSsB/ed+BBnXhv5lPKRtHqNULIexgpED858FUX********************3r87J20AgH8JJ+7uNwoEYO3lps="}

响应参数

Response Header

参数 是否必选 参数类型 描述
Content-Type 是 String 取值为：application/json; charset=UTF-8

Response Body

参数 是否必选 参数类型 描述
resultCode 是 String 结果码，“000000”表示成功，其他表示失败。
resultDesc 是 String 结果描述。
subCode 否 String 业务错误码。
subDesc 否 String 业务错误描述信息。
sign 是 String 签名值。用于开发者对响应报文进行防篡改验证。
sysRefundOrderNo 否 String 华为支付退款订单号。
mercRefundOrderNo 否 String 商户退款订单号。最大长度64。
refundOrderStatus 是 String

退款订单状态：

- REFUND_CHL_PROC：处理中

- REFUND_SUCCESS：成功

- REFUND_FAILED：失败
finishTime 否 String 退款完成时间，UTC时间格式（yyyy-MM-dd'T'HH:mm:ss.SSSZ）。
promotionRefundAmount 否 Long 营销退款金额，单位：分。
refundAmount 否 Long

退款总金额。订单需要退款的金额，该金额不能大于订单金额，单位：分。

说明： 如果正向交易使用了营销，该退款金额包含营销金额，华为支付会按业务规则分配营销和买家自有资金分别退多少，默认按比例退款。如不填则默认payerRefundAmount。
mLong 否 Long 退款给用户的金额，单位：分。
currency 否 String

交易币种单位，最大长度为3。

CNY （默认，当前仅支持该币种单位）
payload 否 String 预留信息，如商户请求时传递该参数，此时会原样返回。

响应示例

HTTP/1.1 200 OK
Content-Type: application/json; charset=UTF-8
{
  "resultCode": "000000",
  "resultDesc": "Success.",
  "sign": "MEUCIQCEA/HVCjAFReiy59wGUp0zQ********************XbPCQAvFhpv1XIIxmlIIv2zaKH3e6YfxkL94=",
  "sysRefundOrderNo": "12407030900270084914518***",
  "mercRefundOrderNo": "czl0012024070914***",
  "refundOrderStatus": "REFUND_SUCCESS",
  "finishTime": "2023-05-15T14:42:09.000+0800",
  "promotionRefundAmount": 0,
  "refundAmount": 2,
  "payerRefundAmount": 2,
  "currency": "CNY",
  "payload": "example-payload"
}

错误码

resultCode非400000的错误码请查看公共错误码说明。

返回码 错误码 错误描述 解决方案
400000 UNKNOW_ERROR 服务暂不可用，请稍后重试 稍后重试。
400000 INVALID_ARGUMENTS 参数不合法 检查请求参数。
400000 PAY_ORDER_NOT_EXIST 支付订单号不存在 检查入参订单号是否正确。
400000 MERC_ORDER_NOT_EXIST 商户订单号不存在 检查入参订单号是否正确。
400000 INVALID_MERCNO 无效商户号 检查入参商户号是否正确。
400000 CHECK_ORDER_STATUS 订单状态异常 请检查是否使用相同订单重复下单。