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 you choose to settle transactions manually, the SETTLEMENT operation triggers settlement with the host.

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.

Tip

When Payment Terminal Application is in demo mode, settlement is not performed. Instead, you simply receive a reminder of the current demo mode status.

Request fields

Request fields for settlement
Field                          Description

Presence       

operation          
Contains the value Transaction.

Mandatory

type          
Send the transaction type with a value of SETTLEMENT.

Mandatory

The following is an example of a Settlement request:

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

Response:

Json
{
  "approval": "approved",
  "batchJulianDay": "25092",
  "batchNumber": "000001",
  "demoMode": "no",
  "merchantID": "9999999",
  "operation": "Transaction",
  "result": "0",
  "terminalID": "009",
  "transactionType": "SETTLEMENT",
  "type": "SETTLEMENT"
}