# 5.4 Query Refund

## 1. Overview <a href="#id-1overview" id="id-1overview"></a>

Use this API to inquire about the refund status of a previously submitted refund request.

## 2. Request Info <a href="#id-2request-info" id="id-2request-info"></a>

* **Method:** post
* **Path:** <https://prod-openapi-v2.newpay.la/beta/pay/uniQueryRefund>

### **2.1 Request Header** <a href="#id-21-request-header" id="id-21-request-header"></a>

| Key          | Value            |
| ------------ | ---------------- |
| Content-Type | application/json |

### **2.2 Request Data** <a href="#id-22-request-data" id="id-22-request-data"></a>

| Name           | Description                                                                                                | Type   | Required |
| -------------- | ---------------------------------------------------------------------------------------------------------- | ------ | -------- |
| appId          | Unique identifier assigned to a third-party application platform                                           | string | true     |
| mchId          | Unique identifier assigned to a third-party merchant                                                       | string | true     |
| newpayRefundNo | Refund order number in NewPay                                                                              | string | false    |
| mchRefundNo    | Refund order number in third-party merchant                                                                | string | false    |
| sign           | [Data signature](https://newpay-api-document.gitbook.io/newpay-api-document/8.-signature-and-verification) | string | true     |

{% hint style="info" %}
Although both `newpayRefundNo` and `mchRefundNo` are optional, **at least one of them must be provided.**
{% endhint %}

### **2.3 Response Data** <a href="#id-23-response-data" id="id-23-response-data"></a>

<table><thead><tr><th>Name</th><th width="277">Description</th><th>Type</th></tr></thead><tbody><tr><td>success</td><td>Success flag: true/false</td><td>boolean</td></tr><tr><td>message</td><td>Response message</td><td>string</td></tr><tr><td>code</td><td><a href="../../9.-business-code#response-code">Reponse code</a></td><td>string</td></tr><tr><td>timestamp</td><td>Response timestamp</td><td>long</td></tr><tr><td>data</td><td>Result</td><td>object</td></tr><tr><td>> newpayRefundNo</td><td>Refund order number in NewPay</td><td>string</td></tr><tr><td>> mchRefundNo</td><td>Refund order number in third party merchant</td><td>string</td></tr><tr><td>> newpayOrderNo</td><td>payment order number in NewPay</td><td>string</td></tr><tr><td>> refundAmt</td><td>Refund amount and currency</td><td>json</td></tr><tr><td>   >> value</td><td>amount</td><td>string</td></tr><tr><td>   >> currency</td><td>CNY: 人民币<br>USD: 美元<br>LAK: 老挝币</td><td>string</td></tr><tr><td>> orderAmt</td><td>original order amount and currency</td><td>json</td></tr><tr><td>   >> value</td><td>amount</td><td>string</td></tr><tr><td>   >> currency</td><td>CNY: 人民币<br>USD: 美元<br>LAK: 老挝币</td><td>string</td></tr><tr><td>> refundStatus</td><td>refund status: SUCCESS/FAIL/PROCESSING</td><td>int</td></tr><tr><td>> sign</td><td>Data signature</td><td>string</td></tr></tbody></table>