# 退款
## 接口说明  <!-- {docsify-ignore} -->

**1. 接口功能说明**

  该接口为接入商家提供交易退款的功能。

 （1）接口补充说明
 * 该接口在消费交易成功后发起，要求指定原订单号
 * 外卡交易当日不能做退款，可以做撤销，只能隔日退款
 * 正常情况下，商户当日退款金额，不得大于当日成功交易额

 （2）接口交易流程

  ![](https://allpayfile-hd2.oss-cn-shanghai.aliyuncs.com/git/b2c/15665469966231.jpg)

## 请求路径  <!-- {docsify-ignore} -->
 
>`POST` /api/v5/refund


## 请求参数  <!-- {docsify-ignore} -->


| 参数          | 类型       | 必填 | 描述                                                         |
| ------------- | ---------- | ---- | ------------------------------------------------------------ |
| orderNum      | String| 是| 退款订单号:商户自行定义，需保证同一商户号下退款订单号不能重复 |
| origOrderNum  | String| 是| 原支付订单号                                                 |
| returnAmount  | String| 是| 退款金额：如 100 元，表示为 100 或 100.00                    |
| orderCurrency | String| 是| 订单币种：ISO标准 如：人民币填写“CNY”,美元填写"USD"          |
| merID         | String| 是| 商户 ID，由 GoAllPay 分配                                       |
| paymentBrand  | String| 是| 支付品牌|
| transTime     | String| 是| 交易时间，格式："yyyyMMddHHmmss"                             |
| backURL       | String| 是| 退款结果异步通知到该URL。退款成功后，GoAllPay 会以 POST JSON 方式调用 backURL 通知退款结果（详见退款结果通知-回调）。商户在接收到通知后，需响应字符串“OK”。 <br>如果没有收到商户响应“OK”，GoAllPay将会过一段时间后重新推送，时间间隔为[15, 15, 15, 30, 180, 1800, 3600, 7200, 14400]，单位为秒。|
| signType      | String| 是| SHA256                                                  |
| signature     | String| 是| 签名          

## 响应参数  <!-- {docsify-ignore} -->

| 参数      | 类型       | 必填 | 描述                                           |
| --------- | ---------- | ---- | ---------------------------------------------- |
| transType    | String| 是| “REFD”                                 |
| orderNum     | String| 是| 退款订单号                                     |
| transID      | String| 是| GoAllPay流水号         |
| merID        | String| 是| 商户 ID |
| paymentBrand | String| 是| 支付品牌|
| respCode     | String| 是| 应答码 00-成功，01-失败。详情见本文档第5章应答码 |
| respMsg      | String| 是| 应答消息                       |
| transTime    | String| 是| 交易时间，格式："yyyyMMddHHmmss"                 |
| gwTime       | String| 是| yyyyMMddHHmmss，为 GW 时间，目前为本地交易时间 |
| returnAmount | String| 是| 退款金额 |
| orderCurrency| String| 是| 订单币种 |
| signType     | String| 是| SHA256                                   |
| signature    | String| 是| 签名                          |