---
sourceType: official-guide
sourceTypeMatchedRule: fallback
slug: OA/quan-ly/mua-san-pham-dich-vu-oa/xac-nhan-thanh-toan-don-hang
title: Xác nhận thanh toán đơn hàng
---
# Xác nhận thanh toán đơn hàng

:::warning Lưu ý
Ứng dụng cần được cấp quyền quản lý Mua sản phẩm dịch vụ OA
:::

## HTTP request

- **URL**: [https://openapi.zalo.me/v3.0/oa/purchase/confirm_order](https://openapi.zalo.me/v3.0/oa/purchase/confirm_order)
- **Method**: POST  
- **Content Type**: application/json  
- **Response Type**: text/json

## Example request:

```bash
curl 
--location 'https://openapi.zalo.me/v3.0/oa/purchase/confirm_order' \ 
--header 'access_token: <oa_access_token>' \ 
--header 'Content-Type: application/json' \ 
--data '{ 
    "order_id": "22ffed32d17738296161",
    "verified_token": "30fVkXZd9j9zWmqQrBhO" 
}'
```

### Tham số header


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| [access_token](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) | string | yes | Token cho phép ứng dụng đại diện OA gọi API. Xem chi tiết cách lấy access token [tại đây.](/docs/OA/bat-dau/xac-thuc-va-uy-quyen-cho-ung-dung-new) |


### Cấu trúc body của request


| Tham số | Kiểu dữ liệu | Tính bắt buộc | Mô tả |
| --- | --- | --- | --- |
| order_id | string | yes | ID đơn hàng - Lấy từ response của [API tạo đơn hàng](/docs/OA/quan-ly/mua-san-pham-dich-vu-oa/tao-don-hang) |
| verified_token (OTT) | string | yes | OTT - One Time Token - Mã xác thực dùng để xác nhận thanh toán đơn hàng - Lấy từ response của [API tạo đơn hàng](/docs/OA/quan-ly/mua-san-pham-dich-vu-oa/tao-don-hang) - OTT sẽ có hiệu lực trong vòng 5 phút kể từ khi Order được khởi tạo |


## Example respond
1/ Example respond cho trường hợp tạo đơn mua hàng (có áp dụng voucher)

```json
{ 
    "error": 0, 
    "message": "Success", 
    "data": { 
        "order_id": "22ffed32d17738296166", 
        "beneficiary_type": "OA", 
        "beneficiary_id": 607812198688816074, 
        "product_id": 757295129578622372, 
        "product_name": "Gói OA Premium 6 tháng", 
        "zca_id": 227233554730318420, 
        "voucher_code": "DISCOUNT_100K", // Không bắt buộc nhập voucher code
        "discount": 100000, // Giá trị chiết khấu tương ứng của voucher
        "amount": 2394000, 
        "final_amount": 2394000, 
        "created_time": 1706581122383 
    }
}
```

2/ Example respond cho trường hợp sử dụng redeem code (mã quà tặng)

```json
{ 
    "error": 0, 
    "message": "Success", 
    "data": { 
        "order_id": "22ffed32d17738296166", 
        "beneficiary_type": "OA", 
        "beneficiary_id": 607812198688816074, 
        "product_id": 757295129578622372, 
        "product_name": "Gói OA Premium 6 tháng", 
        "zca_id": 227233554730318420, 
        "redeem_code": "GIFT_CODE_1", // Mã quà tặng
        "amount": 0, 
        "final_amount": 0, 
        "created_time": 1706581122383 
    }
}
```

### Cấu trúc thuộc tính data

| Tham số | Kiểu dữ liệu | Mô tả |
| --- | --- | --- |
| order_id | string | ID đơn hàng |
| beneficiary_type | string | Chứa các giá trị: OA hoặc APP Là đối tượng được thụ hưởng khi mua đơn hàng. - Lưu ý: Mỗi sản phẩm sẽ quy định đối tượng khả dụng riêng, đối tượng thụ hưởng phải tương ứng với đối tượng khả dụng của sản phẩm. - Tham khảo tài liệu về danh sách sản phẩm [tại đây.](/docs/OA/quan-ly/mua-san-pham-dich-vu-oa/danh-sach-san-pham) |
| beneficiary_id | string | ID của OA (nếu beneficiary_type = OA) ID của App (nếu beneficiary_type = APP) |
| product_id | long | ID sản phẩm |
| product_name | string | Tên sản phẩm |
| zca_id | long | Tài khoản ZCA thanh toán đơn hàng |
| voucher_code | string | Voucher code đã được sử dụng (Nếu có truyền vào voucher_code) |
| redeem_code | string | Mã quà tặng (nếu có truyền vào redeem_code) |
| discount | string | Giá trị của voucher_code. VD: Giảm 10% hay Giảm 100K, ... |
| amount | long | Giá tiền của đơn hàng (chưa áp dụng mã giảm giá) |
| final_amount | long | Giá tiền chính thức sau khi đã sử dụng mã giảm giá |
| created_time | long | Thời điểm tạo đơn hàng, tính bằng millisecond |