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",
  "X-Lang": "en"
}

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.order_id	String	Order ID
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.is_sett	Boolean	Settlement status	true: The transaction has been settled false: The transaction has not been settled
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.updated_at	String	Transaction settlement time (in 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": [
    {
      "order_id": "676979536619700224",
      "transaction_id": "01KXYP0X3YH18V0HB313S5FR89",
      "partner_ref_id": "95OK-EE4V-K6RY-427J",
      "payment_method": "QR",
      "amount": 10000,
      "status": "Success",
      "error_code": "00",
      "error_message": "Success",
      "created_at": "2026-07-20T09:34:59",
      "paid_at": "2026-07-20T09:43:33",
      "is_sett": true,
      "updated_at": "2026-07-20T09:43:34"
    }
  ],
  "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' \
  --header 'X-Lang: en'

Request

REQUEST

Base URL

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

Development server

Path

Auth REQUIRED

Bearer Token

Parameters

page — query REQUIRED

limit — query REQUIRED