Manual Settlement

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

Called to initiate the settlement process from the merchant (sales) app. The reconciliation request is prepared and sent to the host. The settlement result is returned as a summary of transactions grouped by transaction type.

Call example

App2AppRequest app2AppRequest = new App2AppRequest();

// Optional to add register/config parameters

app2AppService.gotoManuelSettlement(app2AppRequest, eventListener);

Request and response

Request

"gotoManuelSettlement": {
  "configParameters": {
    "drawerMenu": "1",
    "salesButton": "0",
    "voidButton": "1",
    "refundButton": "1",
    "historyButton": "1",
    "settingsButton": "1",
    "settlementButton": "0",
    "tipScreen": "0",
    "userPhoto": "1"
  },
  "registerParameters": {
    "terminalId": "00000001",
    "merchantId": "000000000000011",
    "activationCode": "1"
  }
}

Success response

{
  "settlementResult": true,
  "settlementResultMessage": "ACQUIRER_SETTLEMENT_SUCCESS",
  "settlementSaleCount": 10,
  "settlementSaleAmount": 1000,
  "settlementVoidCount": 5,
  "settlementVoidAmount": 530,
  "batchNumber": "1713"
}

Error response

{
  "errorCode": "E104",
  "internalErrorCode": 4,
  "internalErrorSubCode": 1
}