Documentation Index
Fetch the complete documentation index at: https://docs.noxpay.io/llms.txt
Use this file to discover all available pages before exploring further.
This flow requires the Infrastructure product to be enabled on your account. Initiating offramps programmatically also requires a secure API connection — your server’s IP address must be whitelisted on your Noxpay account.
When to use this
Use Offramp when you want to pay someone in BRL using your Noxpay crypto balance — disbursements, payouts, supplier payments, or any flow where you hold crypto and need to deliver BRL to a payee. Your platform initiates the transaction. The required crypto is drawn from your Borderless Account balance, converted, and sent via PIX. The payee does not interact with crypto at any point.Before you can process offramps
- Your Borderless Account must hold enough stablecoin (USDC or USDT) to cover the transaction
- Your server IP must be whitelisted in your Noxpay account settings — requests from unlisted IPs are rejected
- The Infrastructure product must be active on your account
The full flow
Quote
A rate is calculated for the crypto → BRL conversion. The quoted crypto amount is immediately reserved from your available balance for the duration of the session — it moves from available to blocked. The rate is locked at this point.
Pre-KYC
The payee’s CPF (individual) or CNPJ (business) is collected. This is the identity that will receive the PIX payment. The document is validated for format before proceeding.
Payee KYC
The payee’s identity is verified against a Brazilian identity database and their PIX key is collected. The PIX key must belong to the verified document holder. Business payees (CNPJ) go through an additional business identity check.
Conversion
The reserved crypto is converted to BRL at the locked quote rate. Your balance is debited at this point.
PIX transfer
Noxpay sends the BRL amount via PIX to the payee’s registered key. PIX transfers in Brazil typically arrive within minutes.
Balance behaviour
| Moment | What happens to your balance |
|---|---|
| Quote created | Crypto moved from available → blocked |
| Conversion executed | Blocked crypto is debited |
| Transaction fails or expires | Blocked crypto returned to available |
Transaction states
| State | What it means |
|---|---|
Created | Quote generated, crypto reserved from your balance |
Pending | Payee KYC in progress |
Processing | Conversion or PIX transfer in progress |
Success | PIX delivery confirmed, balance permanently debited |
Expired | Session timed out — reserved crypto returned to available |
Failed | System error — reserved crypto returned to available |
Cancelled | Payee identity verification failed — reserved crypto returned to available |
Compliance limits
- Daily limit per payee: R$ 50,000 across all ramp variants. Transactions that would breach this are rejected at initiation.
- Monthly KYC tier: Payees who exceed R$ 50,000 cumulative monthly volume require enhanced financial documentation before the next transaction is processed. See How it works for the full tier structure.
Fees
- Noxpay fee — deducted from BRL sent or from crypto equivalent, configurable per Template
- Merchant fee — optional markup, configurable per Template
- No network fee

