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.
Quando usar
Use o Onramp quando quiser aceitar BRL de um cliente e receber o equivalente em cripto no seu saldo Noxpay — por exemplo, para creditar o saldo interno de um usuário na sua plataforma, financiar operações de trading ou acumular stablecoin para uso posterior. O cripto convertido é creditado internamente. Nenhuma transação on-chain ocorre.O fluxo completo
Cotação
Uma taxa é calculada para a conversão BRL → cripto solicitada. A cotação trava o valor em BRL, o valor em cripto, as tarifas e a taxa de câmbio. A taxa é válida por 10 minutos. Se o cliente não pagar dentro dessa janela, a cotação expira e uma nova é gerada.
Pré-KYC
O cliente informa o CPF (pessoa física) ou CNPJ (empresa). O documento é validado quanto ao formato antes de prosseguir. Esta etapa pode ser ignorada se você pré-preencher o documento ao criar a transação via API.
Pagamento PIX
Um QR code PIX é gerado para o valor em BRL cotado. O cliente paga pelo aplicativo bancário.
Verificação de identidade + verificação de titularidade
Após o recebimento do PIX, o documento do cliente é verificado em uma base de dados de identidade brasileira. A Noxpay também confirma que o CPF do remetente PIX coincide com o documento informado no Pré-KYC. Se forem diferentes, a transação passa para
UNCOMPLIANT e fica retida para análise.Conversão
A Noxpay converte o BRL recebido para a criptomoeda de destino pela taxa de câmbio travada na cotação.
Status de transação
| Status | O que significa |
|---|---|
Created | Cotação gerada, aguardando ação do cliente |
Pending | Verificação de identidade em andamento |
Processing | Conversão em andamento |
Success | Cripto creditado no seu saldo disponível |
Expired | Cliente não pagou dentro da janela da cotação |
Failed | Erro de sistema |
Cancelled | Verificação de identidade falhou ou documento inválido |
UNCOMPLIANT | CPF do remetente PIX não coincide com o documento do pré-KYC — pagamento retido para análise |
Limites de conformidade
- Limite diário por beneficiário: R$ 50.000 em todas as variantes de ramp. Transações que excedam 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. Veja Como funciona para a estrutura completa de faixas.
Taxas
- Taxa Noxpay — percentual, deduzida do cripto recebido
- Taxa do lojista — markup opcional, configurável por Template
- Sem taxa de rede — liquidação é no saldo interno, não on-chain