getOrderStatus
API cho phép đối tác gọi để truy vấn tình trạng 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 để thực hiện tra cứu trạng thái đơn hàng.
API specification
| Method | Headers | Endpoint |
|---|---|---|
| GET | https://payment-mini.zalo.me/api/transaction/get-status |
Parameters
Object object
| Property | Type | Required | Description |
|---|---|---|---|
| orderId | string | true | Mã đơn hàng của yêu cầu thanh toán đã tạo |
| appId | string | true | Id định danh của mini app |
| 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 |
| success | function | Callback function khi gọi api thành công | |
| fail | function | Callback function khi gọi api thất bại |
Tạo thông tin chứng thực
data = "appId={appId}&orderId={orderId}&privateKey={privateKey}";
mac = HMAC("HmacSHA256", privateKey, data);
Return Values
Promise <Object data>
| Property | Type | Description |
|---|---|---|
| transId | string | Mã giao dịch của yêu cầu thanh toán với đối tác thanh toán |
| method | String | Phương thức thanh toán. Tham khảo mã tại đây |
| returnCode | int |
|
| returnMessage | string | Mô tả thông tin returnCode |
| isProcessing | boolean |
|
| amount | long | Số tiền giao dịch |
| transTime | long | Thời gian giao dịch của đối tác thanh toán |
| merchantTransId | String | Mã giao dịch của đối tác thanh toán |
| extradata | String | Thông tin thêm Lưu ý: Dữ liệu này đã được encodeURIComponent |
Error code
Tham khảo tại đây.