updateOrderStatus

Cập nhật lần cuối: 27/05/2022

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, chỉ áp dụng với 2 phương thức thanh toán khi nhận hàng (COD) và chuyển khoản ngâ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 - 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

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	string	true	Trạng thái giao dịch của đơn hàng: 1 : Thành công -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

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

Return Values

Promise <Object data>

Property	Type	Description
error	int	0 : Thành công Khác : Thất bại
msg	string	Mô tả thông tin error