# 退款

## 介绍

- 退款（Refund）是支付完成后（即交易已经请款、资金已到账）的一种逆向交易，用于将部分或全部款项退还给持卡人。它是售后流程中非常重要的一环。
- 退款有可能不是实时到账持卡人账户，可能会需要数个工作日的时间。


## 退款

请求示例
[Refund](/zh-hans/payments/apis/payments/openapi/退款/refund-opl_1)


```json
{
  "merchant_id": "18356675194960",
  "refund_trans_id": "m43986y4t345436",
  "ori_order_id": "GW20620xxxxx6999",
  "refund_amount": 100,
  "currency": "USD"
}
```

成功响应示例


```json
{
  "ret_code": "000000",
  "ret_msg": "Success",
  "data": {
    "merchant_id": "18356675194960",
    "refund_trans_id": "m43986y4t345436",
    "refund_order_id": "RG206xxxxx198",
    "ori_order_id": "GW20620xxxxx6999",
    "status": "PROCESSING",
    "amount": 100,
    "currency": "USD"
  }
}
```

失败响应示例


```json
{
  "ret_code": "010000",
  "ret_msg": "Invalid request"
}
```

## 退款结果查询

请求示例
[Refund Query](/zh-hans/payments/apis/payments/openapi/退款/refund-query-opl_2)


```json
{
  "merchant_id": "18356675194960",
  "refund_order_id": "RG206xxxxx198"
}
```

退款成功响应示例


```json
{
  "ret_code": "000000",
  "ret_msg": "Success",
  "data": {
    "error_code": "0000",
    "error_description": "request success",
    "merchant_id": "18356675194960",
    "refund_trans_id": "1745922548689",
    "refund_order_id": "RG206xxxxx198",
    "ori_order_id": "GW20620xxxxx6999",
    "status": "SUCCESS",
    "amount": 100,
    "currency": "USD"
  }
}
```

退款失败响应示例


```json
{
  "ret_code": "000000",
  "ret_msg": "Success",
  "data": {
    "error_code": "2010",
    "error_description": "The bookkeeping has failed for the refund",
    "merchant_id": "18356675194960",
    "refund_trans_id": "1745922548689",
    "refund_order_id": "RG206xxxxx198",
    "ori_order_id": "GW20620xxxxx6999",
    "status": "FAILURE",
    "amount": 100,
    "currency": "USD"
  }
}
```

## 错误码

参见 [交易错误码](/zh-hans/payments/docs/developer-resources/transanction-error-code)

## 结果通知

参考 [Webhook](/zh-hans/payments/docs/developer-resources/webhook)