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:
Examples | Fri | Sat | Sun | Mon | Tue | Wed | Thu | Fri |
---|---|---|---|---|---|---|---|---|
Scenario 1 | T | T+1 | T+2 | T+3 | ||||
Scenario 2 | T | T+1 | T+2 | T+3 | ||||
Scenario 3 | T | T+1 | T+2 | Public Holiday | T+3 | |||
Scenario 4 | T | T+1 | T+2 | T+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:
Field | Description |
---|---|
revenue | Total attempted collection by Ezypay, includes both failed and successful. |
deduction | Any deduction from revenue , such as failed payment, refunds, Ezypay's fee etc. |
amount | Net amount settled to merchants, calculated as revenue minus deduction . |
status | Settlement status |
date | Settlement 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.
Updated about 1 month ago