Settlement

'Settlement' is when Ezypay distributes funds into the merchant's bank account. Settlement frequencies can be scheduled daily (AU & NZ only), weekly or monthly and can be any day of the merchant's choice.

Settlement includes all successful payments collected, and less any fees required to be deducted within the billing cycle. Along with each settlement, settlement reports will be created and emailed to the merchant's nominated email address.

Due to the processing time required by banks, there is a holding period for the settlement process.

Holding Period:

  • All(except South Korea): 3 business days (T+3).
  • South Korea: 7 business days (T+7).
  • The holding period begins after a successful transaction. See the table below for examples:
ExamplesFriSatSunMonTueWedThuFri
Scenario 1TT+1T+2T+3
Scenario 2TT+1T+2T+3
Scenario 3TT+1T+2Public HolidayT+3
Scenario 4TT+1T+2T+3

*Note: “T” indicates the day of successful transaction.

Below is the flow of settlement process:

Get started

Display settlement overview

Use List Settlement API to fetch and display recent settlement details for merchants. Capture and display the following fields:

FieldDescription
revenueTotal attempted collection by Ezypay, includes both failed and successful.
deductionAny deduction from revenue, such as failed payment, refunds, Ezypay's fee etc.
amountNet amount settled to merchants, calculated as revenue minus deduction.
statusSettlement status
dateSettlement date

The API only provides an overview, for detail settlement information, refer to the reporting guide to generate the detailed settlement reports.

Update invoice settlement status

Ezypay sends a transaction_settled webhook event when transactions are settled to the merchant. Use the invoiceId from the webhook to identify the associated invoice and update its settlement status on your platform, allowing merchants to reconcile with funds received in their accounts easily.