Transaction list

Endpoint: /api/v2/partner/orders/transactions

Method: GET

Header: How to generate a JWT_TOKEN

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

Request params

Parameter	Requirement	Data types	Description
payment_method	optional	String	Payment methods (POS, QR)
page	required	String
limit	required	String

Response Params

Success

Http Status Code 200 - OK

Parameter	Data types	Description	Notes
transactions	Array Object	Transaction information
transaction.transaction_id	String	AppotaPay transaction ID
transaction.partner_ref_id	String	Partner reference transaction ID
transaction.status	String	Transaction status	pending = The transaction is pending. processing = The transaction is being processed. success = The transaction is successful. error = The transaction has failed. void = The transaction has been refunded.
transaction.amount	Integer	Transaction amount
transaction.error_code	Integer	Transaction error code (Note: returned only if status != success)
transaction.error_message	String	Transaction status details (Note: returned only if status != success)
transaction.payment_method	String	Payment methods
transaction.created_at	String	Transaction creation time (ISO 8601 format)
transaction.paid_at	String	Transaction payment time (ISO 8601 format)
pagination	Object
pagination.limit	string	Limit
pagination.page	string	Page
pagination.total	string	Total
pagination.total_items	string	Total Items

Failure

HTTP Status Code != 200

Parameter	Data types	Description
error_code	String	Error code
error_message	String	Error code description

Example

Response

{
  "transactions": [
    {
      "transaction_id": "01KF33A1JNTD6ZE42T42ZVN7P3",
      "partner_ref_id": "asdnndaudddssdsddnwduu",
      "status": "pending",
      "amount": 123456,
      "error_code": "34",
      "error_message": "Giao dịch đang chờ xử lý",
      "payment_method": "POS",
      "created_at": "2026-01-16T16:48:42",
      "paid_at": ""
    }
  ],
  "pagination": {
    "limit": 1,
    "page": 1,
    "total": 10,
    "total_items": 10
  }
}

Code Example

curl --location 'https://pos-gw.dev.appotapay.com/api/v2/partner/orders/transactionspage=1&limit=25' \
  --header 'X-APPOTAPAY-AUTH: JWT_TOKEN' \
  --header 'Content-Type: application/json'

Request

REQUEST

Base URL

https://pos-gw.dev.appotapay.com

Development server

Path

Auth REQUIRED

Bearer Token

Parameters

page — query REQUIRED

limit — query REQUIRED