Enabling manual settlement for virtual/cardless payments

Learn how to enable manual settlement for virtual/cardless payments

Terminology

AbbreviationAbbreviation meaningDescription
POSPoint of saleThe machine/medium in which a sale was made.
EOD till summaryEnd of dayThe transactions of the entire station for the day.
Cashier till summaryThe transactions from the beginning to the end of the cashier's shift.

Background

By default, merchant accounts are set to automatic settlement. A settlement report is generated from successful transaction data from the previous 24-hour period (00:00 AM GMT+8 to 23:59 PM GMT+8) daily.

The automatic settlement must be disabled to activate manual settlement. Once enabled, you can generate a settlement by triggering an externally exposed API endpoint.

How to enable manual settlement

  1. Log in to your account and click on Settings.

  2. Click Payments.

  3. Click Edit.

  4. Untick Enable for Automated Settlements.

Manually requesting a settlement

Once the automatic settlement has been disabled, the account will wait for the API endpoint to generate the settlement.

The API will return the following details.

Parameter nameDescription
idThe ID of the settlement generated
merchantIdThe ID of the Setel merchant's account
idempotentIdThe ID of the request to generate the settlement. This is to prevent duplicated requests.
typeThe type of transaction in the settlement file
totalTransactionsThe number of transactions in the settlement
statusThe status of generating the settlement.
amountThe amount of the settlement in RM.

Note

  • Manual settlement only affects Setel-managed virtual transactions. Transactions under Setel would be transactions with the type prime for Setel Wallet and virtual loyalty for Setel’s loyalty points.
  • Even though the settlement is generated manually, the time the financial document is sent and processed by the bank will not change. Each bank has a different processing time. Please check with the respective bank for more details.
  • A settlement is equivalent to the POS end of day till summary. It is not the cashier till summary.
  • You can do more than one settlement a day but on the bank's side, they will be compiled into a single settlement for the day.