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.
Este fluxo requer o produto Infrastructure habilitado na sua conta. Iniciar offramps via API também exige uma conexão de API segura — o IP do seu servidor deve estar na whitelist da sua conta Noxpay.
Quando usar
Use o Offramp quando quiser pagar alguém em BRL usando seu saldo de cripto na Noxpay — desembolsos, pagamentos a fornecedores, repasses ou qualquer fluxo em que você mantém cripto e precisa entregar BRL a um beneficiário. Sua plataforma inicia a transação. O cripto necessário é reservado do seu saldo na Borderless Account, convertido e enviado via PIX. O beneficiário não interage com cripto em nenhum momento.Antes de processar offramps
- Sua Borderless Account deve ter stablecoin suficiente (USDC ou USDT) para cobrir a transação
- O IP do seu servidor deve estar na whitelist nas configurações da sua conta Noxpay — requisições de IPs não listados são rejeitadas
- O produto Infrastructure deve estar ativo na sua conta
O fluxo completo
Cotação
Uma taxa é calculada para a conversão cripto → BRL. O valor em cripto cotado é imediatamente reservado do seu saldo disponível pelo tempo da sessão — ele passa de disponível para bloqueado. A taxa é travada neste momento.
Pré-KYC
O CPF (pessoa física) ou CNPJ (empresa) do beneficiário é coletado. Esta é a identidade que receberá o pagamento PIX. O documento é validado quanto ao formato antes de prosseguir.
KYC do Beneficiário
A identidade do beneficiário é verificada em uma base de dados de identidade brasileira e a chave PIX é coletada. A chave PIX deve pertencer ao titular do documento verificado. Beneficiários empresariais (CNPJ) passam por uma verificação adicional de identidade empresarial.
Conversão
O cripto reservado é convertido para BRL pela taxa de câmbio travada na cotação. Seu saldo é debitado neste momento.
Transferência PIX
A Noxpay envia o valor em BRL via PIX para a chave registrada do beneficiário. Transferências PIX no Brasil normalmente chegam em minutos.
Comportamento do saldo
| Momento | O que acontece com seu saldo |
|---|---|
| Cotação criada | Cripto movido de disponível → bloqueado |
| Conversão executada | Cripto bloqueado é debitado |
| Transação falha ou expira | Cripto bloqueado retorna ao disponível |
Status de transação
| Status | O que significa |
|---|---|
Created | Cotação gerada, cripto reservado do seu saldo |
Pending | KYC do beneficiário em andamento |
Processing | Conversão ou transferência PIX em andamento |
Success | Entrega PIX confirmada, saldo debitado permanentemente |
Expired | Sessão expirou — cripto reservado retornou ao disponível |
Failed | Erro de sistema — cripto reservado retornou ao disponível |
Cancelled | Verificação de identidade do beneficiário falhou — cripto reservado retornou ao disponível |
Limites de conformidade
- Limite diário por beneficiário: R$ 50.000 em todas as variantes de ramp. Transações que ultrapassem esse limite são rejeitadas na iniciação.
- Faixa de KYC mensal: Beneficiários que ultrapassem R$ 50.000 de volume mensal acumulado precisam de documentação financeira aprimorada antes de a próxima transação ser processada. Veja Como funciona para a estrutura completa de faixas.
Taxas
- Taxa Noxpay — deduzida do BRL enviado ou do equivalente em cripto, configurável por Template
- Taxa do lojista — markup opcional, configurável por Template
- Sem taxa de rede