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

> Cliente paga via PIX e o cripto convertido é creditado no seu saldo Noxpay.

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

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

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

  <Step title="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.
  </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 informado no 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="Success">
    O cripto convertido é creditado no seu **saldo disponível**. Um webhook é enviado com o valor creditado e a taxa de câmbio utilizada.
  </Step>
</Steps>

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

## Dashboard

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