UnblockPay API
UnblockPay is a stablecoin banking API that enables businesses and individuals to create stablecoin wallets across various blockchains and seamlessly move between stablecoins and fiat currencies – globally.
Sandbox environment for testing
Customers (Collapsed)
Customers are users of your business who can be either individuals or businesses. You must create a customer before processing any pay-ins or payouts.
- get/v1/customers
- post/v1/customers
- get/v1/customers/{customer_id}
- post/v1/customers/{customer_id}/documents
- post/v1/customers/{customer_id}/check
- get/v1/customers/{customer_id}/verification-details
- post/v1/customers/{customer_id}/verification-link
- post/v1/customers/{customer_id}/questionnaire
- get/v1/customers/{customer_id}/rails
- get/v1/customers/{customer_id}/limits
External Accounts (Collapsed)
External accounts represent the bank account or payment destination of a customer — for example, a PIX key, a CLABE (SPEI), a wire transfer account, a SEPA IBAN, or an Argentine CVU/CBU. You must create an external account before initiating a payout.
Wallets (Collapsed)
Wallets are stablecoin accounts deployed on a supported blockchain (Solana, Ethereum, Polygon, Tron, or Base) and associated with a customer. Each wallet has an on-chain address and can hold USDC or USDT balances.
Virtual Accounts (Collapsed)
Virtual accounts provide dedicated fiat banking deposit details (account number, IBAN, sort code, etc.) that automatically convert incoming fiat deposits into stablecoins and deliver them to a specified wallet. Supported fiat currencies are USD, EUR, and GBP.
Transactions (Collapsed)
Transactions represent money movements processed through the UnblockPay platform. There are three types: on_ramp (fiat to crypto), off_ramp (crypto to fiat), and wallet_transfer (crypto to crypto). Each transaction moves through a lifecycle of statuses from awaiting_deposit to a terminal state (completed, failed, error, or cancelled).
Payouts (Collapsed)
Payouts convert stablecoins into fiat currency (off-ramp). The customer sends crypto from a wallet and receives fiat at a bank account or payment destination via their local payment rail (PIX, SPEI, Wire, SEPA, or CVU). Each payout references a quote that locks in the exchange rate for 5 minutes.
Pay-ins (Collapsed)
Pay-ins convert fiat currency into stablecoins (on-ramp). The customer sends fiat via their local payment rail (PIX, SPEI, or Wire) and receives stablecoins (USDC or USDT) at the destination wallet. Each pay-in references a quote that locks in the exchange rate for 5 minutes.
Quotes (Collapsed)
Quotes provide a locked-in exchange rate for a fiat-to-stablecoin (on-ramp) or stablecoin-to-fiat (off-ramp) conversion. Create a quote before initiating a transaction to get a price with fees already calculated. Quotes expire after 5 minutes.
Partner Fees (Collapsed)
Partner fees are fees a partner adds on top of UnblockPay's base fee when creating quotes. UnblockPay collects them and periodically pays them out, in stablecoin, to the partner's fee wallet. Use these endpoints to list those payments.
Webhooks (Collapsed)
Webhook configurations allow you to receive real-time event notifications when transactions or other resources change state. Each partner has a single webhook configuration that defines the HTTPS endpoint and the list of event types to subscribe to.
Fiat-to-Fiat (Collapsed)
Fiat-to-fiat operations move funds directly between two fiat currencies (e.g. BRL → USD) using a stablecoin as the internal bridge. Each operation creates two linked transactions: an on-ramp (sender fiat → stablecoin) and an off-ramp (stablecoin → receiver fiat). Request a composite quote via POST /v1/quote/fiat-to-fiat before creating a transaction.
