Settlement

What happens after your Intent is accepted — how and when funds are transferred.

Overview

Once your Intent is accepted, settlement begins immediately: the solver reserves liquidity and starts the DvP settlement workflow, with the authoritative state recorded on-chain by the Intent settler contract (Created → Filled → Settled). You don't need to manage settlement directly — Ezys coordinates with the liquidity sources and settlement partners to complete the transfer.

With a firm quote attached, your accepted Intent executes at the locked rate and itemized fees — these do not change during settlement. Without one, it settles within the bounds you set (minOutputAmountMinor / input.limitAmountMinor).

Settlement Paths

Each accepted Intent settles through one or more Legs — individual asset movements. The settlement path depends on the asset types involved.

Asset type	Path	Timing
Crypto (USDC, etc.)	On-chain — smart contract execution	Near-instant
Fiat (KRW, USD, etc.)	Off-chain — partner settlement rails	Varies by partner and rail

A typical Intent (e.g. USDC → KRW) involves two Legs: an on-chain outflow and an off-chain inflow.

Tracking Settlement

An execution advances through three phases — intent (acceptance) → offramp (FX conversion) → payout (fiat delivery) — and reports an aggregate status:

Status	What it means for you
in_progress	Settlement is in progress — the phase field says which leg is being processed
completed	All phases completed — the beneficiary has received the funds
failed	A phase failed terminally — a structured failure block says where and why

Track progress via webhooks (push, see Webhooks) or the Status API (pull): GET /v1/executions/{reference}, resolvable by your own clientReference — see Status API (coming soon). Both read from the same store and never disagree.

Settlement Preference

You choose the settlement path via the Intent's required settlementType field (on quote requests, the equivalent optional field is settlementPref):

Value	Behavior
hybrid	Ezys selects the optimal settlement path (the quote-side default)
onchain	Prefer on-chain settlement where possible
offchain	Prefer off-chain settlement where possible

In most cases, hybrid is recommended. Ezys will choose the path that best balances speed and cost.

What You Don't Need to Manage

• Liquidity source selection — handled by the Solver Network
• Settlement coordination — handled by Ezys and its partners
• On-chain transactions — executed automatically via smart contracts
• Off-chain rail selection — determined by the settlement path

Your responsibility ends at submitting the Intent. Ezys handles everything from acceptance to fund delivery.

Related

• Execution & Settlement (Core Concepts) — How settlement works under the hood
• Intent API — Full API reference