Skip to main content

Settlement

Host-based processing stores each transaction as it is processed throughout a business day. After the business day is closed, the Payment Terminal Application automatically settles stored transactions into a batch and provides a batch identification (ID) number. 

The backend settlement time is predefined and made known to you once your account is set up, as the application and host work in “host capture” mode.  The default settlement time is in the early AM hours of the morning and settles the previous day's transactions. The settled transaction's monetary value disperses into the settling bank account within 48 hours. If chosen to settle transactions manually, the Settlement operation triggers the settlement with the host.

If there are open pre-authorizations or tabs, the application automatically prints the respective reports. During this operation, the Payment Terminal Application prompts you to confirm the settlement summary as informed by the host before performing the settlement. The Settlement Report is produced during this operation.

The following is an example of a Settlement request:

Json
{
    "operation": "Transaction",
    "type": "SETTLEMENT"
}

Response:

Json
{
    "approval": "approved",
    "batchJulianDay": "25031",
    "batchNumber": "000002",
    "cardholderReceipt": "\n\n\nRRN: 000000012544\nTax Number: 0\nSat,Feb 01,2025         01:25:44\n\n           SETTLEMENT\n\n            APPROVED\n\n\nAMOUNT                     $0.00\nSUBTOTAL                   $0.00\nTIP                        $0.00\n            ____________________\nTOTAL                      $0.00\n\nBatch#: 031-002\n\n\n          Customer copy\n       THANK YOU! / MERCI!\n        Please Come Again\n",
    "demoMode": "no",
    "merchantID": "9999999",
    "merchantReceipt": "\n\n\nRRN: 000000012544\nTax Number: 0\nSat,Feb 01,2025         01:25:44\n\n           SETTLEMENT\n\n            APPROVED\n\n\nAMOUNT                     $0.00\nSUBTOTAL                   $0.00\nTIP                        $0.00\n            ____________________\nTOTAL                      $0.00\n\nBatch#: 031-002\n\n\n          Merchant copy\n       THANK YOU! / MERCI!\n        Please Come Again\n",
    "operation": "Transaction",
    "result": "0",
    "terminalID": "041",
    "transactionType": "SETTLEMENT",
    "type": "SETTLEMENT"
}