XKOVA Docs

Conversion and Ramps

The rails move stablecoin value. Conversion is how that value connects to fiat. A conversion partner turns fiat into stablecoin on the way in and stablecoin back into fiat on the way out. Production partners are swappable and configured per tenant. Every sandbox workspace receives XKOVA's sandbox conversion partner automatically, without changing how its integration calls the rails.

The conversion partner

A conversion partner is the vendor that holds reserves and exchanges fiat for stablecoin. XKOVA talks to the partner through a stable interface, quoting a rate, requesting a mint or a burn, and reading the request to settlement. The orchestration layer presents the same conversion shape regardless of which partner is active, which is the model from Integrations and Orchestration applied to ramps.

The two ramps

RampDirectionWhat the partner does
On rampFiat to digitalTakes fiat and mints or releases stablecoin onto the rails.
Off rampDigital to fiatTakes stablecoin and pays fiat out to the bank.

The request side of both ramps, how you create and follow a funding or off-ramp request, is on Funding and Off-ramp. This page covers the partner that sits behind those requests.

Quote, then act

A conversion starts with a quote at the partner's current rate. From a quote, the partner issues a mint for an on ramp or accepts a burn for an off ramp, returning a request you read to completion. Because settlement depends on the partner, and for an off ramp also on an on chain transfer confirming and on the receiving bank confirming the fiat credit has posted, the request is asynchronous: create it, then poll it or subscribe to events to learn when it settles or fails. See Webhooks for event delivery.

For an off ramp, the member's wallet burns the stablecoin to the partner first. That outbound transfer uses the same owner-signature, XKOVA acceptance, and relayer path as other rail movements. See Transfers and Settlement and the custody and signing model on Non-custodial Model.

Example vendors

The conversion adapter is interchangeable. Examples of the kind of partner that plugs in here include Coinbase, Paxos, and Anchorage. Each production tenant runs one configured partner; moving to another changes nothing about how the rails fund value in or cash value out.

Every sandbox workspace instead receives XKOVA's sandbox conversion partner automatically. It runs the same funding and off-ramp lifecycle against on-chain dUSDC on Avalanche Fuji and Base Sepolia, including deterministic happy, partial, and failure scenarios. This keeps the developer path production-shaped without pretending demo funds are issuer-controlled USDC or fiat-backed value.

Circle Testnet USDC is also listed on both chains as a separate supported asset. Acquire it from Circle's faucet or a pre-funded wallet. The sandbox conversion partner does not mint or substitute it.

Related

For the exact conversion and ramp operations and their request and response shapes, see the operations list or try them live in the interactive reference.