Skip to main content
Settlements let you move part or all available Ivy balance to your external bank account or wallet—automatically or on demand. Use this to sweep your desired amount of fiat funds into for reucrring treasury operations, or settling pre-set wallets in fiat or stablecoins.

Fiat Settlement

Settle to your local bank account in EUR, GBP & more. Funds usually arrive instant, but can take up to 2 business days.

Stablecoin Settlement

Settle fiat to stablecoins. Get on-demand or recurring settlement to stablecoins at market FX rates.

​
How It Works

1

Configure your settlement destination

Set your destination bank account or wallet address for settlements in the Accounts Tab per account under Settlement preferences
To enable stablecoin settlements contact Ivy
2

Choose settlement frequency and amount

  • Automatic: Settle daily, weekly, or monthly
  • Manual: Trigger a settlement anytime from the Dashboard or API
  • Amount: Minimum amounts apply to Stablecoin settlements
3

Set minimum balance (optional)

Retain a buffer for refunds or payouts. Only the amount above this threshold will be settled.Minimum balances can be edited in the Accounts Tab per account under Settlement preferences
4

Track settlements

All settlements are included in your Payout Reports for easy reconciliation.

​
Supported Currencies & Chains

  • Fiat: EUR, GBP, and more (to local bank accounts)
  • Stablecoin: USDC (Ethereum, Solana, Polygon)
Stablecoin settlements to wallets on Ethereum or Polygon are limited by the blockchain’s speed and can take up to 20 minutes. For instant stablecoin settlements, we recommend using Solana.
To enable stablecoin settlements, contact Ivy to get started.

​
How to Create a Settlement

  • API: Use the /beneficiary-payout/create endpoint to trigger a manual settlement.
  • Dashboard: In the Accounts tab, select the account to settle, enter amount, and click “Settle Funds”.

​
Stablecoin Settlements

Settle custom amounts of your Ivy fiat balance into stablecoins using the settlement feature via the dashboard or API
Minimum Settlement amounts into USDC = 10 source currency (EUR/GBP)

​
How It Works

1

Get a real-time exchange rate

Use the /fx/retrieve-rate endpoint to fetch the current rate for your desired currency pair.
2

Create a settlement

Use the /beneficiary-payout/create endpoint to convert and settle your balance in the target currency to your wallet.
3

Fetch FX details

After creating a settlement, you’ll receive an fxId on the settlement object. Use this fxId with the /fx/retrieve endpoint to fetch details about the exchange rate and conversion used for that specific settlement.
4

Track settlement status

Monitor your settlement in the Dashboard or via webhooks. Funds usually arrive instantly, but can take up to 2 business days depending on the destination.

​
API Reference

​
1. Retrieve Exchange Rate

Get the real-time exchange rate for a specific currency pair. 
POST /api/service/fx/retrieve-rate
{
  "sourceCurrency": "EUR",
  "targetCurrency": "USDC"
}

{
  "rate": 1.085,
  "targetAmount": 1.085,
  "sourceAmount": 1
}
View full API reference

​
2. Create Settlement

Triggering a settlement can either sweep all or custom amounts of your fiat balances to then automatically convert them to stablecoins, and settle to your linked wallet. 
POST /api/service/beneficiary-payout/create
{}

[
  {
    "id": "1234567890",
    "type": "beneficiary-payout",
    "referenceId": "ref_1234567890",
    "merchant": "merchant_1234567890",
    "amount": 1,
    "currency": "EUR",
    "status": "pending"
  }
]

​
3. Retrieve Settlement Details

Check the status of your settlement, corresponding transaction hash, and FX details in the Dashboard or via the /fx/retrieve endpoint.