resultCode返回“000000”表示查询退款订单成功，不代表退款成功，退款状态需根据refundOrderStatus字段判断。
退款订单状态：
REFUND_CHL_PROC：处理中
REFUND_SUCCESS：成功
REFUND_FAILED：失败
您当前正在浏览HarmonyOS最新文档，覆盖已发布的所有API版本，可在API参考中筛选您使用的API版本。详细的版本配套关系请参考版本说明。
通过sysRefundOrderNo查询退款订单信息
本文导读
功能介绍
开发者可以调用该接口查询某笔退款订单详细信息。
说明
场景描述
该接口支持所有的华为支付退款订单查询，若开发者已有申请退款的订单，可以通过该接口查看具体退款订单的退款状态。
接口原型
承载协议： HTTPS GET
接口方向： 开发者服务器 -> 华为支付服务器
接口URL： https://petalpay-developer.cloud.huawei.com.cn/api/v1/aggr/transactions/refunds/orders/{sysRefundOrderNo}
数据格式：
请求消息：Content-Type: application/json; charset=UTF-8
响应消息：Content-Type: application/json; charset=UTF-8
请求参数
Request Header
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| Content-Type | 是 | String | 取值为：application/json; charset=UTF-8 |
| PayMercAuth | 是 | String | 取值为：PayMercAuth的JSON字符串 |
Request Path
| 参数 | 是否必选 | 参数类型 | 描述 |
|---|---|---|---|
| sysRefundOrderNo | 是 | String | 华为支付退款订单号。 |
请求示例
- GET /api/v1/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/Q********************o6Run7iCj1mWYBYJIPB75/UrhP0aBflpW1J8Sf8VUt6orCWk=","bodySign":"haZnDZSsB/ed+BBnXhv5lPKR********************H8JJ+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 | 否 | 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********************IxmlIIv2zaKH3e6YfxkL94=",
- "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 | 订单状态异常 | 请检查是否使用相同订单重复下单。 |
