updateOrderStatus

Cập nhật lần cuối: 26/07/2024

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 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 Với phương thức thanh toán riêng: 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

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

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

Return Values

Promise <Object data>

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.