---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: MA/checkoutSdk/apis/updateOrderStatus
title: updateOrderStatus
---
API cho phép đối tác gọi để **cập nhật** tình trạng thanh toán của 1 đơn hàng

Đố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 (hoặc thực hiện việc cập nhật trên trang quản lý Mini App) để thực hiện việc cập nhật trạng thái thanh toán của đơn hàng khi người dùng đã trả tiền cho đơn vị kinh doanh.

## API specification

| Method | Headers | Endpoint                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                                       |
| ------ | ------- | -------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| POST   |         |  • Với phương thức **thanh toán khi nhận hàng (COD)**: [https://payment-mini.zalo.me/api/transaction/\{Mini-App-ID}/cod-callback-payment](https://payment-mini.zalo.me/api/transaction/{Mini-App-ID}/cod-callback-payment) • Với phương thức **chuyển khoản ngân hàng**: [https://payment-mini.zalo.me/api/transaction/\{Mini-App-ID}/bank-callback-payment](https://payment-mini.zalo.me/api/transaction/{Mini-App-ID}/bank-callback-payment) • Với phương thức **thanh toán riêng**: [https://payment-mini.zalo.me/api/transaction/\{Mini-App-ID}/custom-callback-payment](https://payment-mini.zalo.me/api/transaction/{Mini-App-ID}/custom-callback-payment) • Với các phương thức **sử dụng API purchase**: [https://payment-mini.zalo.me/api/transaction/\{Mini-App-ID}/purchase-payment](https://payment-mini.zalo.me/api/transaction/{Mini-App-ID}/purchase-payment)  |

## Parameters

### Object _object_

| Property   | Type   | Required | Description                                                                                                        | Use to build mac |
| ---------- | ------ | -------- | ------------------------------------------------------------------------------------------------------------------ | ---------------- |
| appId      | string | true     | Id định danh của mini app                                                                                          | true             |
| orderId    | string | true     | Mã đơn hàng của yêu cầu thanh toán đã tạo                                                                          | true             |
| resultCode | number | true     | Trạng thái giao dịch của đơn hàng:  • 1 : Thành công • 0 : Đã hoàn tiền • -1 : Thất bại | true             |
| mac        | string | true     | Thông tin chứng thực của đơn hàng, xem cách tạo thông tin chứng thực cho đơn hàng ở dưới                           |                  |

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

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

## Return Values

### Promise \

| Property | Type   | Description                                                                                                   |
|----------|--------|---------------------------------------------------------------------------------------------------------------|
| err      | int    |  • 0 : Thành công • Khác : Thất bại                                                      |
| msg      | string | Mô tả thông tin error                                                                                         |
| error    | int    | Giá trị giống `err` Trường này tồn tại để tương thích với các phiên bản cũ, đối tác nên dùng trường `err` |

### Error code

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