> ## Documentation Index
> Fetch the complete documentation index at: https://opendocs.xft.xin/llms.txt
> Use this file to discover all available pages before exploring further.

# 查询退款接口

## 功能说明

根据商户编码和退款流水号查询退款单的处理结果，包括退款状态、退款金额、渠道与平台退款流水号等信息。

## 请求地址

`POST /v1/aggregate/payment/charge/refund/get`

## 请求参数

| 字段                | 类型     | 必填 | 说明            |
| ----------------- | ------ | -- | ------------- |
| `merchant_code`   | string | 是  | 商户编码          |
| `refund_trade_no` | string | 是  | 退款流水号（商户退款单号） |

## 请求示例

```json theme={null}
{
  "merchant_code": "226801000000865319122",
  "refund_trade_no": "R20231025152300001"
}
```

## 响应参数

| 字段                  | 类型     | 说明                                                                                |
| ------------------- | ------ | --------------------------------------------------------------------------------- |
| `trade_state`       | string | 退款状态，详见 [TradeState 枚举](/open/xianghe/aggregate-payment-v1/get-charge#tradestate) |
| `failure_code`      | string | 失败码                                                                               |
| `failure_msg`       | string | 失败信息                                                                              |
| `trade_no`          | string | 渠道退款流水号                                                                           |
| `platform_trade_no` | string | 平台退款流水号                                                                           |
| `amount`            | object | 退款金额，详见下方 Amount 说明                                                               |
| `succeeded_at`      | string | 退款成功时间，格式：`yyyyMMddHHmmss`；示例值：`20220912111230`                                   |

**Amount 对象**

| 字段               | 类型     | 说明                                 |
| ---------------- | ------ | ---------------------------------- |
| `total`          | int    | 订单总金额，单位：分                         |
| `payer_total`    | int    | 用户支付金额，单位：分（使用优惠券的情况下，等于总金额减优惠券金额） |
| `currency`       | string | 订单金额货币类型；`CNY`：人民币，境内商户号仅支持人民币     |
| `payer_currency` | string | 用户支付货币类型                           |

## 响应示例

```json theme={null}
{
  "trade_state": "00",
  "failure_code": "",
  "failure_msg": "",
  "trade_no": "50300807092023102512345678901",
  "platform_trade_no": "20231025152300000002",
  "amount": {
    "total": 100,
    "payer_total": 100,
    "currency": "CNY",
    "payer_currency": "CNY"
  },
  "succeeded_at": "20231025152300"
}
```