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. The partner is a swappable adapter chosen per tenant during XKOVA onboarding, so an institution runs with the partner it trusts, and XKOVA can move a tenant to a different partner without any change to 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 is a signed, non-custodial move like any other on the rails. See Transfers and Settlement and the non-custodial 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 tenant runs one partner, chosen with XKOVA at onboarding; moving to another changes nothing about how the rails fund value in or cash value out. In the sandbox, a simulated conversion partner runs funding and off-ramp end to end before any vendor contract, with deterministic happy, partial, and failure scenarios for testing the unhappy paths before going live.

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.