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:
Checkout Embutido
O iframe do ninepay.js dentro da sua página, com a aparência dela.
Checkout ExternoRedirecione o cliente para uma página da NinePay e receba o resultado por webhook.
Nos dois casos, libere o acesso pelo webhook, 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.