# 退款

## 退款

<mark style="color:green;">`POST`</mark> `BASE_URL/api`

#### Headers

| Name                                           | Type   | Description                       |
| ---------------------------------------------- | ------ | --------------------------------- |
| content-type<mark style="color:red;">\*</mark> | String | application/x-www-form-urlencoded |

#### Request Body

| Name                                                    | Type   | Description                                         |
| ------------------------------------------------------- | ------ | --------------------------------------------------- |
| version<mark style="color:red;">\*</mark>               | String | max=5 调用的接口版本，固定为：1.0                               |
| merchantNo<mark style="color:red;">\*</mark>            | String | max=16 商户号，由 USEEPAY 分配                             |
| transactionId<mark style="color:red;">\*</mark>         | String | max=64 商户订单号，建议每次请求的 transactionId 唯一，有利于后续订单查询和对账。 |
| transactionType<mark style="color:red;">\*</mark>       | String | max=18 交易类型：refund                                  |
| originalTransactionId<mark style="color:red;">\*</mark> | String | max=64 原始预授权完成/支付商户订单号                              |
| amount<mark style="color:red;">\*</mark>                | String | max=12 订单金额（必须大于 0），单位为对应币种的最小货币单位(详见 ISO 4217)     |
| currency<mark style="color:red;">\*</mark>              | String | max=3 3 位 ISO 大写字母货币代码(详见 ISO 4217)。退款币种需与正向交易币种相同  |
| signType<mark style="color:red;">\*</mark>              | String | max=4 商户生成签名字符串所使用的签名算法类型                           |
| sign<mark style="color:red;">\*</mark>                  | String | max=256 商户请求参数的签名串                                  |
| notifyUrl                                               | String | USEEPAY 回调商户地址                                      |

{% tabs %}
{% tab title="200: OK " %}

```javascript
{
    "amount": "1", 
    "resultCode": "pending",
    "sign": "035bfd3acf5732e6ce9c9f772bf85158",
    "errorCode": "0000",
    "transactionId": "202110141059261", // 商户订单号，需保证在商户端不重复
    "errorMsg": "Approved or completed successfully",
    "transactionType": "refund", // 交易类型：refund
    "reference": "1062110141059650859", 
    "echoParam": "echoParam",
    "originalTransactionId": "202110141054086",
    "reserved": "reserved",
    "signType": "MD5",
    "currency": "USD",
    "merchantNo": "500000000007381" // 商户编号，由 USEEPAY 分配
}
```

{% endtab %}
{% endtabs %}

### Response

<table data-header-hidden><thead><tr><th width="182.21637426900585">字段</th><th>描述</th><th width="150" data-type="checkbox">必要</th><th data-hidden>描述</th></tr></thead><tbody><tr><td>version</td><td>max=5 调用的接口版本，固定为：1.0</td><td>true</td><td></td></tr><tr><td>merchantNo</td><td>max=16 商户编号，由 USEEPAY 分配</td><td>true</td><td></td></tr><tr><td>transactionId</td><td>max=64商户订单号，需保证在商户端不重复</td><td>true</td><td></td></tr><tr><td>transactionType</td><td>max=18 交易类型：refund</td><td>true</td><td></td></tr><tr><td>reference</td><td>max=32USEEPAY 订单号</td><td>false</td><td></td></tr><tr><td>amount</td><td>max=12 支付金额，单位为对应币种的最小货币单位(详见 ISO 4217)</td><td>true</td><td></td></tr><tr><td>currency</td><td>max=3 3 位 ISO 大写字母货币代码(详见 ISO 4217)</td><td>true</td><td></td></tr><tr><td>resultCode</td><td>max=32 业务结果（<a href="https://useepay.gitbook.io/useepay/api/resultCode">详见 业务结果码）</a></td><td>true</td><td></td></tr><tr><td>errorCode</td><td>max=4 错误码（<a href="https://useepay.gitbook.io/useepay/api/errorCode">详见 错误码 errorCode）</a></td><td>false</td><td></td></tr><tr><td>errorMsg</td><td>max=256 错误码消息描述</td><td>false</td><td></td></tr><tr><td>echoParam</td><td>max=256 回声参数，响应报文会原样返回</td><td>false</td><td></td></tr><tr><td>reserved</td><td>max=256 预留字段，值同请求报文</td><td>false</td><td></td></tr><tr><td>sign</td><td>max=256 商户请求参数的签名串</td><td>true</td><td></td></tr></tbody></table>