Transaction List

Last updated: August 1, 2026 | Guide version: 1.0.8

Used to get a list of transactions for the given list type value. When called with list type information, the payment app opens and shows the list of transactions in the payment app. This API does not return the list of transactions as a response to the merchant (sales) app. Void/refund list can be used to see transactions available to void/refund and initiate the operation externally by clicking the button near each transaction; the transaction result is only shown on the payment app screen and not sent to the merchant app (use the Payment API to get the payment response). History list shows transactions done so far, with an option to create/recreate a receipt by clicking the "Receipt" button near each transaction.

List types

List	listType
Refund List	`3000`
Void List	`4000`
History List	`5000`

Call example

App2AppRequest app2AppRequest = new App2AppRequest();

// Optional to add register/config parameters

app2AppRequest.setListType("3000");
app2AppService.gotoList(app2AppRequest, eventListener);

Request and response

Request

"gotoList": {
  "listType": "3000"
}

Success response

"response": {
  "a2aCode": "1010",
  "a2aMessage": "SoftposApp Stopped"
}

Error response

"response": {
  "a2aCode": "1003",
  "a2aMessage": "Register error : Server Error please contact with your administrator",
  "errorCode": "104",
  "errorMainCode": "9",
  "errorSubCode": "32"
}

Response fields

Field	Description
`a2aCode`	Response code created in the Softpos application
`a2aMessage`	Message of a2aCode. Backend message can be added to the continuation.
`errorCode`	Returned from the backend. If an error code is returned from the backend, errorCode is not null.
`errorMainCode`	Error main code returning from backend. All error codes and explanations are available in the softpos sdk document.
`errorSubCode`	Error sub code returning from backend.