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 Instant quando quiser converter BRL para cripto e entregar diretamente na carteira externa de um cliente — sem passar pelo seu saldo Noxpay. O cripto convertido vai direto on-chain para o endereço especificado na criação da transação. Este é o fluxo correto quando seus usuários possuem suas próprias carteiras e esperam receber cripto lá, em vez de em um saldo de conta na sua plataforma.O fluxo completo
Cotação
Uma taxa é calculada para a conversão BRL → cripto. A cotação trava o valor em BRL, o valor em cripto (líquido de tarifas, incluindo taxa de rede), a taxa de câmbio e o endereço de carteira de destino. A taxa é válida por 10 minutos.
Pré-KYC
O cliente informa o CPF ou CNPJ. O formato é validado 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 do 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.
Transferência on-chain
A Noxpay transmite uma transação blockchain para o endereço de carteira especificado na criação. A transação entra em
Processing enquanto aguarda a confirmação on-chain.Partial Success
Se a conversão for bem-sucedida mas a transferência on-chain falhar — por exemplo, porque o endereço da carteira é inválido ou há um problema de rede na confirmação final — a transação liquida como Partial Success. O cripto convertido é creditado no seu saldo Noxpay em vez da carteira externa. Nenhum BRL é reembolsado. Você retém o cripto e pode sacá-lo manualmente ou tratá-lo pelo seu próprio processo de reconciliação.Endereços whitelist vs. avulsos
Endereço whitelist — uma carteira pré-aprovada registrada na sua conta Noxpay. Use quando o destino é fixo ou controlado pela sua plataforma. Endereço avulso — uma carteira arbitrária enviada na criação da transação. Use quando cada usuário tem sua própria carteira externa que muda por transação. A Noxpay faz uma verificação básica de formato mas não valida a propriedade.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 concluída, transferência on-chain em andamento |
Success | Cripto confirmado on-chain na carteira de destino |
Partial Success | Conversão concluída, mas entrega on-chain falhou — cripto creditado no seu saldo |
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 |
Limites de conformidade
- Limite diário por beneficiário: R$ 50.000 em todas as variantes de ramp.
- Faixa de KYC mensal: Beneficiários que ultrapassem R$ 50.000 de volume mensal acumulado precisam de documentação aprimorada. Veja Como funciona.
Taxas
- Taxa Noxpay — percentual, deduzida do cripto recebido
- Taxa do lojista — markup opcional, configurável por Template
- Taxa de rede — custo da transação blockchain, cobrado na cotação e incluído no valor exibido ao cliente