Balances and Settlements
Settle your available balance into your external bank account or wallet
Settlement
Triggering Settlements
The balance of your Ivy collection account is the net of payins and payouts in the relevant local currency, e.g. EUR, GBP, SEK, DKK. Settlements are triggered periodically (monthly, weekly, daily), at which point the available balance of each fiat account is paid out to your beneficiary wallet or bank account. Settlement can also be triggered manually through the Ivy Merchant Dashboard.
By default the entire available balance will be settled. However, you can define a minimum balance for your account which will be retained on the account to maintain sufficient balance for refunds or customer payouts.
Fiat Settlements
Settlements in fiat are made to the bank account you specified during onboarding. Settlements usually arrive instantly, but can take up to 2 business days.
By default settlement must be to a locally connected bank account in the same currency as the Ivy account. Fiat FX payouts are possible, however, stablecoin settlements are recommended for cases where you don’t hold a local fiat account to receive settlements.
Stablecoin Settlements
Ivy provides you with the option to settle your available fiat balance on-chain in stablecoins. Stablecoin settlement also enables higher frequency or real-time settlement.
The conversion of fiat to stablecoins happens at the moment the settlement is triggered at market rates. Ivy is connected with Stablecoin issuers directly to provide you with the best possible rate at any given time.
We currently support the following currencies
- USDC
- EURC
on the following chains
- Ethereum
- Solana
- Polygon
Please reach out to your Ivy point of contact in order to activate stablecoin settlements
Reporting
You can use the Payout Report API to get a list of all settlements made to your beneficiary account in a certain period. Settlements are paid out regularly, and the payout report will show you all transactions included in a given settlement payout.
Create a Payout Report
To create a payout report, request the Create Payout Report endpoint. You must provide the intervalStart
and intervalEnd
fields in the request body as UNIX timestamps.
Example Request Payload
In the response, you receive the id
and the initial status
of the payout report. You can use this id
to retrieve the status later and download the payout report.
Example Response Payload
Poll for the report status
After you have created the payout report, the report is gathered asynchronously and usually takes around 30 seconds to be ready. You can poll the Retrieve Payout Report endpoint to get the current status of the payout report. You must provide the reportId
of the payout report in the request body.
Example Request Payload
As a response, you will receive the payout report’s current status.
Example Response Payload
Download the report
The status will switch to ’ succeeded ’ as soon as the payout report is ready. Use the Download Payout Report endpoint to download the payout report. You need to provide the reportId
of the payout report in the request path and specify the format of the Download. You can receive the report in JSON format or as a CSV file.
Example Request Payload
You will receive the report in the JSON response if you specify JSON as the format. The report will contain a list of all payouts made to your bank account. Each payout will have the id
of the payout, the availableAt
date, the amount
, and a list of all orders included in the payout.
Example Response Payload
If the report is not ready, you will receive a status400
response.