Xác nhận thanh toán đơn hàng

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
• Method: POST
• Content Type: application/json
• Response Type: text/json

Example request:

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	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.

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
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 - 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)

{ 
    "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)

{ 
    "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.
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