---
agentTools:
  projectIndex: https://docs.ninepay.com.br/llms.txt
  projectSearch: https://docs.ninepay.com.br/agentSearch?query=term1%20term2
---

# Checkout

Receba o pagamento na sua página ou numa página hospedada pela NinePay

Você pode deixar a NinePay coletar os dados de pagamento de duas formas:

<Cards columns={2}>
  <Card title="Checkout Embutido" icon="🧩" href="/docs/checkout-embutido">O iframe do ninepay.js dentro da sua página, com a aparência dela.</Card>
  <Card title="Checkout Externo" icon="🔗" href="/docs/checkout-externo">Redirecione o cliente para uma página da NinePay e receba o resultado por webhook.</Card>
</Cards>

Nos dois casos, libere o acesso pelo [webhook](/docs/webhooks), nunca pelo retorno do navegador.

## Qual escolher

- **Checkout externo:** para integrar rápido, sem desenvolver tela de pagamento. O cliente sai do seu site e paga numa página da NinePay.
- **Checkout embutido:** para o cliente não sair do seu site. O pagamento acontece num iframe da NinePay dentro da sua página, com a aparência dela.

## Diferenças

| | Checkout externo | Checkout embutido (ninepay.js) |
|---|---|---|
| Onde o cliente paga | Numa página da NinePay, para onde você redireciona o cliente | Na sua página, num iframe da NinePay |
| O que fica na sua página | Nada da tela de pagamento | Título, valor e o botão de pagar; o iframe mostra os métodos, os campos do cartão e o QR do PIX |
| Antes de integrar | Nada | Cadastrar no dashboard os endereços do site que abrem o iframe (até cinco) |
| Assinatura | Crie plano, cliente e assinatura e redirecione para `https://checkout.ninepay.com.br/subscription/<uuid>/activate` | Crie a assinatura com `method` e sem cartão; a primeira fatura fica em aberto e pagá-la no iframe ativa a assinatura |
| Métodos | Os da página da NinePay | Cartão, PIX Automático, PIX e boleto (sem Open Finance: o banco não abre num iframe) |
| Dados do cartão | Ficam na página da NinePay | Vão do iframe direto para a NinePay; a sua página nunca os vê |

Nos dois casos, o token da API fica só no seu servidor.