Pular para o conteúdo principal

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 Offramp Instant quando um terceiro deposita cripto para financiar o pagamento. Seu saldo Noxpay não é utilizado em nenhum momento. Comum em contextos P2P e B2B, onde o remetente mantém cripto e o destinatário precisa de BRL. O pagador envia cripto da própria carteira; o beneficiário recebe BRL via PIX. Podem ser a mesma pessoa (um usuário resgatando sua própria carteira) ou pessoas diferentes (um pagador quitando uma fatura em nome de um destinatário).

O fluxo completo

Cotação → Pré-KYC → KYC do Beneficiário → Depósito de Cripto → Conversão → Transferência PIX → Success
1

Cotação

Uma taxa é calculada para a conversão cripto → BRL. A cotação trava o valor de depósito esperado — incluindo um pequeno sufixo único (veja abaixo), o valor em BRL que o beneficiário receberá, as tarifas e a taxa. A taxa é travada neste momento.
2

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.
3

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.
4

Depósito de Cripto

Um endereço de depósito blockchain único é gerado para esta transação. O pagador deve enviar o valor exato com sufixo exibido para esse endereço. A Noxpay monitora o endereço e prossegue assim que o depósito correto é confirmado on-chain.
5

Conversão

O cripto depositado é convertido para BRL pela taxa de câmbio travada na cotação.
6

Transferência PIX

A Noxpay envia o valor em BRL via PIX para a chave registrada do beneficiário.
7

Success

A entrega PIX é confirmada. Um webhook é enviado com o txHash do depósito de cripto de entrada.

O sufixo de depósito

Para evitar identificação incorreta de transações — onde dois depósitos simultâneos do mesmo valor poderiam ser atribuídos à sessão errada — a Noxpay adiciona um pequeno valor único ao depósito esperado. Por exemplo, se o valor cotado for 100.000000 USDT, a instrução de depósito exibida ao pagador pode indicar 100.000017 USDT. O pagador deve enviar esse valor exato. Enviar o número redondo (100.000000) não corresponderá à transação. Certifique-se de que sua interface comunique claramente ao pagador o valor exato com sufixo.

Expiração da cotação no depósito de cripto

Se o depósito de cripto não chegar antes da expiração da sessão, a transação é definida como Expired. Uma nova transação deve ser criada. Se um depósito chegar com atraso (após a expiração), a Noxpay o detecta e credita o cripto recebido no seu saldo Noxpay. Entre em contato com o suporte se precisar resolver um caso de chegada tardia.

Status de transação

StatusO que significa
CreatedCotação gerada, endereço de depósito ativo, aguardando transferência on-chain
PendingKYC do beneficiário em andamento ou depósito on-chain aguardando confirmação
ProcessingConversão ou transferência PIX em andamento
SuccessEntrega PIX confirmada
ExpiredCripto não chegou antes da expiração da sessão
FailedErro de sistema
CancelledVerificação de identidade do beneficiário falhou

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. Veja Como funciona para a estrutura completa de faixas.

Taxas

  • Taxa Noxpay — deduzida do valor em BRL enviado ou do equivalente em cripto, configurável por Template
  • Taxa do lojista — markup opcional, configurável por Template
  • Taxa de rede — custo de confirmação on-chain de entrada, incluído nos valores cotados

Dashboard

Transações de Offramp Instant aparecem em Noxpay Infra → Offramps. Transações concluídas também aparecem como lançamentos em Conta → Extrato.