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

# Onramp para Endereço Externo

> Cliente paga via PIX e o cripto convertido é entregue on-chain para uma carteira externa.

<Note>
  Este fluxo requer o produto **Infrastructure** habilitado na sua conta.
</Note>

## 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 → Pré-KYC → Pagamento PIX → Verificação de Identidade → Conversão → Transferência On-chain → Success
```

<Steps>
  <Step title="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**.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Pagamento PIX">
    Um QR code PIX é gerado para o valor em BRL cotado. O cliente paga pelo aplicativo bancário.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Conversão">
    A Noxpay converte o BRL recebido para a criptomoeda de destino pela taxa de câmbio travada na cotação.
  </Step>

  <Step title="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.
  </Step>

  <Step title="Success">
    A entrega on-chain é confirmada. O payload do webhook inclui o `txHash` da transação blockchain.
  </Step>
</Steps>

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

<Warning>
  Sempre valide endereços de carteira no seu lado antes de criar uma transação. Cripto enviado para um endereço incorreto não pode ser recuperado, e uma entrega on-chain falha resulta em Partial Success, não em reembolso.
</Warning>

## 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](/pt/core-products/ramps/how-it-works).

## 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

## Dashboard

Transações de Onramp Instant aparecem em **Noxpay Infra → Onramps**. Transações concluídas também aparecem como lançamentos de crédito em **Conta → Extrato**.