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

# Offramp da Conta Global

> Cripto é debitado do seu saldo Noxpay e o equivalente em BRL é enviado ao beneficiário via PIX.

<Note>
  Este fluxo requer o produto **Infrastructure** habilitado na sua conta. Iniciar offramps via API também exige uma **conexão de API segura** — o IP do seu servidor deve estar na whitelist da sua conta Noxpay.
</Note>

## Quando usar

Use o Offramp quando quiser pagar alguém em BRL usando seu saldo de cripto na Noxpay — desembolsos, pagamentos a fornecedores, repasses ou qualquer fluxo em que você mantém cripto e precisa entregar BRL a um beneficiário.

Sua plataforma inicia a transação. O cripto necessário é reservado do seu saldo na Conta Global, convertido e enviado via PIX. O beneficiário não interage com cripto em nenhum momento.

## Antes de processar offramps

* Sua Conta Global deve ter stablecoin suficiente (USDC ou USDT) para cobrir a transação
* O IP do seu servidor deve estar na whitelist nas configurações da sua conta Noxpay — requisições de IPs não listados são rejeitadas
* O produto Infrastructure deve estar ativo na sua conta

## O fluxo completo

```
Cotação → Pré-KYC → KYC do Beneficiário → Conversão → Transferência PIX → Success
```

<Steps>
  <Step title="Cotação">
    Uma taxa é calculada para a conversão cripto → BRL. O valor em cripto cotado é imediatamente **reservado** do seu saldo disponível pelo tempo da sessão — ele passa de disponível para bloqueado. A taxa é travada neste momento.
  </Step>

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

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

  <Step title="Conversão">
    O cripto reservado é convertido para BRL pela taxa de câmbio travada na cotação. Seu saldo é debitado neste momento.
  </Step>

  <Step title="Transferência PIX">
    A Noxpay envia o valor em BRL via PIX para a chave registrada do beneficiário. Transferências PIX no Brasil normalmente chegam em minutos.
  </Step>

  <Step title="Success">
    A entrega PIX é confirmada. Seu saldo é reduzido permanentemente pelo equivalente em cripto. Um webhook é enviado confirmando a conclusão.
  </Step>
</Steps>

## Comportamento do saldo

| Momento                   | O que acontece com seu saldo            |
| ------------------------- | --------------------------------------- |
| Cotação criada            | Cripto movido de disponível → bloqueado |
| Conversão executada       | Cripto bloqueado é debitado             |
| Transação falha ou expira | Cripto bloqueado retorna ao disponível  |

## Status de transação

| Status       | O que significa                                                                            |
| ------------ | ------------------------------------------------------------------------------------------ |
| `Created`    | Cotação gerada, cripto reservado do seu saldo                                              |
| `Pending`    | KYC do beneficiário em andamento                                                           |
| `Processing` | Conversão ou transferência PIX em andamento                                                |
| `Success`    | Entrega PIX confirmada, saldo debitado permanentemente                                     |
| `Expired`    | Sessão expirou — cripto reservado retornou ao disponível                                   |
| `Failed`     | Erro de sistema — cripto reservado retornou ao disponível                                  |
| `Cancelled`  | Verificação de identidade do beneficiário falhou — cripto reservado retornou ao disponível |

## 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 antes de a próxima transação ser processada. Veja [Como funciona](/pt/core-products/ramps/how-it-works) para a estrutura completa de faixas.

## Taxas

* Taxa Noxpay — deduzida do BRL enviado ou do equivalente em cripto, configurável por Template
* Taxa do lojista — markup opcional, configurável por Template
* Sem taxa de rede

## O que acontece se o saldo for insuficiente?

Se sua Conta Global não tiver stablecoin suficiente no momento da cotação, a Noxpay rejeita a transação antes de qualquer reserva ser realizada. Exiba um erro adequado ao seu usuário em vez de deixar a falha ocorrer silenciosamente.

<Warning>
  Inicie offramps apenas do seu backend em um IP com whitelist. Nunca exponha as credenciais ou a capacidade de iniciar débitos de saldo a código client-side.
</Warning>

## Dashboard

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