# 返回退款审核结果

> phone | 2in1 | tablet | tv | wearable

## 功能介绍

> phone | 2in1 | tablet | tv | wearable

此接口用于开发者将退款审核结果返回给IAP服务器。

## 场景描述

> phone | 2in1 | tablet | tv | wearable

用户申请退款后，IAP服务会将退款审核信息回调给开发者服务器，开发者服务器根据退款审核信息处理退款后，调用该接口将退款审核结果告知IAP服务器。

## 接口原型

> phone | 2in1 | tablet | tv | wearable

* **承载协议：** HTTPS POST

* **接口方向：** 开发者服务器 -> IAP服务器

* **接口URL：** {rootUrl}/post-sales/harmony/v1/transactions/refund/result

  说明：rootUrl具体请参见[站点信息](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-rest-common-statement#站点信息)。
* **数据格式：**

  请求消息：Content-Type: application/json; charset=UTF-8

  响应消息：Content-Type: application/json; charset=UTF-8

## 请求参数

> phone | 2in1 | tablet | tv | wearable

### Request Header

> phone | 2in1 | tablet | tv | wearable

|参数|是否必选|参数类型|描述|
|:------------|:---|:-----|:--------------------------------------------------------------------------------------------------------------------------------------------|
|Content-Type|是|String|取值为：application/json;charset=UTF-8|
|Authorization|是|String|认证信息，使用JWT进行鉴权，具体请参见[Authorization说明](https://developer.huawei.com/consumer/cn/doc/harmonyos-references/iap-jwt-description#authorization说明)。|

### Request Body

> phone | 2in1 | tablet | tv | wearable

|参数|是否必选|参数类型|描述|
|:----------------|:---|:----------------------------|:------------------------------------------------------|
|reviewType|是|Integer|审核结果。 1：同意退款 2：拒绝退款|
|refundBatchNo|是|String|退款工单号/批次号。|
|remark|否|String|审核结果备注，reviewType为2时需返回拒绝理由。|
|notifyTime|是|Long|通知时间，UTC时间戳，即自1970年1月1日0时起到商户通知的毫秒数。|
|applicationId|是|String|应用ID。|
|totalRefundAmount|否|Long|开发者同意的退款总金额，单位：分。reviewType为1时必填。|
|currency|否|String|币种，reviewType为1时必填。 CNY：人民币|
|reviewResultList|是|[ReviewResult](#reviewresult)|订单退款明细，开发者同意退款时，需要明确返回每笔订单退款金额，**如果部分订单拒绝退款，则退款金额返回0**。|

### ReviewResult

> phone | 2in1 | tablet | tv | wearable

|参数|是否必选|类型|说明|
|:----------------|:---|:------|:----------------------------------------------------------------------------------------------------------------------------------|
|purchaseOrderId|是|String|订单中心订单号，按照系统通知的透传。最大长度256。|
|payMoney|是|Long|订单实付金额，单位：分。|
|refundMoney|是|Long|开发者同意的退款金额，单位：分。|
|consumptionStatus|否|Integer|权益使用状态，可选值。 1：未使用 2：部分使用 3：全部使用|
|ratio|否|Integer|权益使用程度，百分制，取值范围：0~100。 - 当consumptionStatus为1时，ratio必须为0 - 当consumptionStatus为2时，ratio不能为0或者100 - 当consumptionStatus为3时，ratio必须为100|
|playTime|否|Integer|权益使用时长，可选值。 0：未知 1：0-5分钟 2：5-60分钟 3：1-6小时 4：6-24小时 5：1-4天 6：4-16天 7：16天以上|

## 请求示例

> phone | 2in1 | tablet | tv | wearable

```javascript
POST /post-sales/harmony/v1/transactions/refund/result
Content-Type: application/json;charset=UTF-8
Authorization: Bearer ***.***.***
Accept: application/json
{
  "refundBatchNo": "***",
  "reviewType": 1,
  "notifyTime": 1741085489609,
  "applicationId": "***",
  "totalRefundAmount": 1290,
  "currency": "CNY",
  "reviewResultList": [
    {
      "purchaseOrderId": "***",
      "payMoney": 1290,
      "refundMoney": 1290
    }
  ]
}
```

## 响应参数

> phone | 2in1 | tablet | tv | wearable

### Response Header

> phone | 2in1 | tablet | tv | wearable

|参数|是否必选|参数类型|描述|
|:-----------|:---|:-----|:---------------------------------|
|Content-Type|是|String|取值为：application/json;charset=UTF-8|

### Response Body

> phone | 2in1 | tablet | tv | wearable

|参数|是否必选|参数类型|描述|
|:---------|:---|:-----|:----------------------------------------------------------------------------------------------|
|returnCode|是|String|返回码。 0：成功 1：参数错误 990106：无效的审核类型 990107：审核订单与申请订单不匹配 990109：超期未处理工单不允许通过API审核 990110：当前退款状态不支持审核|
|returnDesc|是|String|响应描述。|
|subErrCode|否|String|如果returnCode不为0，表示具体错误原因。 200：鉴权信息不通过 211：JWT格式不正确|

## 响应示例

> phone | 2in1 | tablet | tv | wearable

```javascript
HTTP/1.2 200 OK
Content-Type: application/json;charset=UTF-8
{
  "returnCode": "0",
  "returnDesc": "success"
}
```