Nhảy tới nội dung
Phiên bản: Lastest

API Chi tiết giao dịch

Endpoint: /api/v2/partner/orders/transaction/:partner_ref_id

Method: GET

Header: Cách tạo JWT_TOKEN 

{
  "X-APPOTAPAY-AUTH": "JWT_TOKEN",
  "X-Request-Id": "Your_Unique_id",
  "Content-Type": "application/json",
  "X-Lang": "vi"
}

Request params​

Tham sốYêu cầuKiểu dữ liệuMô tả
partner_ref_idrequiredStringMã tham chiếu của giao dịch partner

Response Params​

Thành công​

Http Status Code 200 - OK

Tham sốKiểu dữ liệuMô tảLưu ý
transaction_idStringMã giao dịch AppotaPay
order_idStringMã đơn hàng
statusStringTrạng thái GD

pending = Giao dịch đang chờ xử lý.

processing = Giao dịch đang tiến hành xử lý.

success = Giao dịch thành công.

error = Giao dịch thất bại.

void = Giao dịch hoàn tiền.

is_settBooleanTrạng thái kết toán của GD

true: Giao dịch đã kết toán

false: Giao dịch chưa kết toán

amountIntegerSố tiền thanh toán
error_codeIntegerMã lỗi giao dịch (Lưu ý: chỉ trả về trong trường hợp status != success)
error_messageStringThông tin chi tiết trạng thái giao dịch (Lưu ý: chỉ trả về trong trường hợp status != success)
payment_methodStringPhương thức thanh toán
created_atStringThời gian tạo giao dịch (định dạng chuẩn ISO_8601)
updated_atStringThời gian kết toán giao dịch (định dạng chuẩn ISO_8601)
paid_atStringThời gian thanh toán (định dạng chuẩn ISO_8601)

Thất bại​

HTTP Status Code != 200

Tham sốKiểu dữ liệuMô tả
error_codeStringMã lỗi
error_messageStringChi tiết mã lỗi

Ví dụ​

Response​

{
  "order_id": "676979536619700224",
  "transaction_id": "01KXYP0X3YH18V0HB313S5FR89",
  "payment_method": "QR",
  "amount": 10000,
  "status": "success",
  "error_code": "00",
  "error_message": "Giao dịch thành công",
  "created_at": "2026-07-20T09:34:59",
  "paid_at": "2026-07-20T09:43:33",
  "is_sett": true,
  "updated_at": "2026-07-20T09:43:34"
}

Ví dụ Code​

curl --location 'https://pos-gw.dev.appotapay.com/api/v2/partner/orders/transaction/:partner_ref_id' \
  --header 'X-APPOTAPAY-AUTH: JWT_TOKEN' \
  --header 'X-Request-Id: UUID' \
  --header 'Content-Type: application/json' \
  --header 'X-Lang: vi'

Request​

REQUEST

Development server