---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: MA/checkoutSdk/apis/getRefundStatus
title: getRefundStatus
---
API cho phép đối tác gọi để truy vấn tình trạng hoàn tiền của 1 giao dịch hoàn tiền.

## API specification

| Method | Headers | Endpoint                                                                           |
| ------ | ------- | ---------------------------------------------------------------------------------- |
| GET    |         | [https://payment-mini.zalo.me/api/refund](https://payment-mini.zalo.me/api/refund) |

### Parameters

#### Object _object_

| Property | Type   | Required | Description                                                    |
| -------- | ------ | -------- | -------------------------------------------------------------- |
| appId    | string | true     | Id định danh của mini app                                      |
| refundId | string | true     | Id của yêu cầu hoàn tiền                                       |
| mac      | string | true     | Thông tin chứng thực, xem cách tạo thông tin chứng thực ở dưới |

### Tạo thông tin chứng thực

```jsx
data = "appId={appId}&refundId={refundId}&privateKey={privateKey}";
mac = HMAC("HmacSHA256", privateKey, data);
```

### Return Values

#### Promise \

| Property      | Type   | Description                                                                                     |
| ------------- | ------ | ----------------------------------------------------------------------------------------------- |
| returnCode    | int    |  • 1 : Hoàn tiền giao dịch thành công •  != 1 : Hoàn tiền không thành công |
| returnMessage | string | Mô tả thông tin returnCode                                                                      |

#### Error code

Tham khảo tại [đây](/docs/MA/checkoutSdk/errorcodes).