---
sourceType: api-reference
sourceTypeMatchedRule: api-prefix
slug: TS/apis/queryOrder
title: Truy vấn trạng thái giao dịch
---
API cho phép Merchant chủ động truy vấn trạng thái giao dịch trên Transfer Service.

- **URL**: `https://api-transfer.zaloplatforms.com/v1/order/query`
- **Method**: `POST`
- **Response Type**: `application/json`

### Parameters

| Trường        | Kiểu dữ liệu | Bắt buộc | Mô tả                                                     | Yêu cầu                                                           |
| ------------- | ------------ | -------- | --------------------------------------------------------- | ----------------------------------------------------------------- |
| `app_id`      | String       | true     | ID ứng dụng merchant đăng ký với Transfer Service         | Phải là `app_id` đã đăng ký với Transfer Service                  |
| `ts_order_id` | String       | true     | Mã giao dịch do Transfer Service cấp (trả về khi tạo đơn) | Mã hợp lệ, tồn tại trên hệ thống                                  |
| `timestamp`   | Long         | true     | Thời điểm tạo request (timestamp)                         | Dùng để validate request                                          |
| `signature`   | String       | true     | Thông tin xác thực request                                | Chữ ký dùng để xác thực request. [Xem tài liệu](/docs/TS/usage/gen_signature) |

### Sample request

```json
{
  "app_id": "0752a0528b1762493b06",
  "ts_order_id": "9a03a90382466b183257",
  "app_time": 0,
  "timestamp": 1764041335432,
  "signature": "81d0afa7b1c4754d7db7703726159c697cbd74cdeafced0aa8c039854becfac7"
}
```

### Sample response

```json
{
  "error_code": 0,
  "error_message": "Thành công",
  "data": {
    "merchant_order_id": "251209_24fbc663-f83",
    "ts_order_id": "5e096d1f465aaf04f64b",
    "order_time": 1765257674274,
    "created_time": 1765257674312,
    "expire_time": 1765257974312,
    "expire_duration": 5,
    "updated_time": 1765257850060,
    "amount": 100000,
    "description": "1765257674274",
    "qr_data": "00020101021238570010A000000727012700069704220113VQRQAAUMJ54040208QRIBFTTA530370454061000005802VN62280107NPS6869081317652576742746304EC5F",
    "paid_amount": "0",
    "paid_time": 1765257712000,
    "transaction_detail": "QAAUMI9446  ZTRANS47 4 59ee13....",
    "status": "PAID",
    "status_code": 2
  }
}
```

### Error codes

| Error code | Error message          | Ghi chú                     |
| ---------- | ---------------------- | --------------------------- |
| -105       | Invalid signature      | Lỗi chữ ký xác thực request |
| -402       | Invalid order id       | Mã giao dịch không hợp lệ   |
| -501       | Invalid application id | Application id không hợp lệ |
| -510       | Application not exist  | Application không tồn tại   |

### Order status

| Status code | Status message | Mô tả                                                                                                     |
| ----------- | -------------- | --------------------------------------------------------------------------------------------------------- |
| 1           | QR_GENERATED   | Đang chờ thanh toán                                                                                       |
| 2           | PAID           | Đã thanh toán                                                                                             |
| 3           | EXPIRED        | Đã hết hạn chờ thanh toán từ ngân hàng. Merchant tự kiểm tra sao kê tài khoản để biết trạng thái thực tế. |