Skip to main content
Settlements let you move your available Ivy balance to your external bank account or wallet—automatically or on demand. Use this to sweep funds for treasury, pay yourself, or settle with partners.

Fiat Settlement

Settle to your local bank account in EUR, GBP, and more. Funds usually arrive instantly, 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 bank account or wallet address in the Dashboard. Contact Ivy to enable stablecoin settlements.
2

Choose settlement frequency

  • Automatic: Settle daily, weekly, or monthly
  • Manual: Trigger a settlement anytime from the Dashboard or API
3

Set minimum balance (optional)

Retain a buffer for refunds or payouts. Only the amount above this threshold will be settled.
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 take up to 20 minutes. For instant stablecoin settlements, we recommend using Solana.
To enable stablecoin settlements, Ivy support must configure this for your account. Contact your Ivy account manager to get started.

​
How to Create a Settlement

  • API: Use the /beneficiary-payout/create endpoint to trigger a manual settlement.
  • Dashboard: Go to the Settlements section and click “Initialize Manual Payout”.

​
Stablecoin Settlements

Settle your Ivy balance in a different currency using FX conversion.

​
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

Trigger a settlement that will sweep your fiat balances, convert them to stablecoins, and settle to your 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.