Build an offramp
USDT → Pix integration. Quote, conversion, deposit, settlement.
How to build an offramp integration with BlendFi: the end customer deposits USDT, receives BRL via Pix.
Concepts form the mental model, Operations give per-call detail. Financial mechanics live in Fees, and the runnable walkthrough in Build a USDT → Pix payout.
Concepts
Overview
Mental model of the offramp in three entities.
Quote
Immutable rate snapshot, valid for 5 minutes.
Conversion
Central offramp entity and its states.
Per-user, per-type lock
One open offramp conversion per end customer.
Operations
Creating a quote
POST /v1/quotes with prerequisites and 5-minute TTL.
Accepting the quote
POST /v1/quotes/:id/accept. Creates the conversion and opens the 15-minute window.
Receiving the deposit
Exact, partial, and overpayment paths.
Standby and manual liquidation
POST /v1/conversions/:id/liquidate. Why the rate changes.
Cancellation
POST /v1/conversions/:id/cancel, valid only before any deposit.
Abandoned conversion
What happens after 7 days in standby.