---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: MA/checkoutSdk/apis/createRefund
title: createRefund
---
API cho phép đối tác hoàn tiền toàn phần hoặc từng phần của 1 giao dịch thanh toán với ZaloPay hoặc Momo.

Đối với API này, sẽ không được tích hợp sẵn trong Payment SDK. Đơn vị kinh doanh cần chủ động xây dựng phương án gọi API này để thực hiện hoàn tiền.

:::note Lưu ý

- Quy tắc hoàn tiền dựa vào các quy tắc hoàn tiền của đối tác thanh toán.

:::

## API specification

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

### Parameters

#### Object _object_

| Property    | Type   | Required | Description                                                    |
| ----------- | ------ | -------- | -------------------------------------------------------------- |
| appId       | string | true     | Id định danh của mini app                                      |
| transId     | string | true     | Mã giao dịch muốn hoàn tiền (mã được trả về khi thanh toán)    |
| amount      | long   | true     | Số tiền muốn hoàn lại cho khách hàng                           |
| description | string |          | Lý do 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}&transId={transId}&amount={amount}&description={description}&privateKey={privateKey}";
mac = HMAC("HmacSHA256", privateKey, data);
```

### Return Values

#### Promise \

| Property      | Type   | Description                                                                                                                                                                                           |
| ------------- | ------ | ----------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| refundId      | string | Id của yêu cầu hoàn tiền                                                                                                                                                                              |
| returnCode    | int    |  • 1 : Hoàn tiền giao dịch thành công • < 1 : Hoàn tiền thất bại, cần thực hiện lại giao dịch  • > 1 : Đang hoàn tiền, gọi getRefundStatus api để lấy trạng thái cuối cùng |
| returnMessage | string | Mô tả thông tin returnCode                                                                                                                                                                            |

#### Error code

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