Pagamentos — Checkout & Payment Links
Pagamentos
Checkout & Payment Links
Chega de construir checkout do zero. Com Payment Links você emite um link que já carrega página de pagamento, instruções de Pix e boleto, parcelamento e opção de recorrência.
O que é um Payment Link
Um payment link é um objeto de cobrança vinculado a uma página pronta de pagamento. Você o cria via API ou diretamente no portal, envia para o cliente e a plataforma cuida da página, da captura do pagamento e da notificação.
- Pix e cartão na mesma cobrança (tipo combinado) ou meios isolados.
- Parcelamento de cartão com simulação de parcelas antes de cobrar.
- Assinatura: cobre o cliente de forma recorrente de acordo com o ciclo escolhido.
- Pagamento por cartão e por cartão (duplo) para split de carteiras.
Ciclos de recorrência
| Ciclo | Intervalo |
|---|---|
| weekly | Semanal |
| biweekly | Quinzenal |
| monthly | Mensal |
| quarterly | Trimestral |
| semiannually | Semestral |
| yearly | Anual |
Billing types
O payment link pode ser de cobrança única parcelada (installment) ou de assinatura (subscription). Na assinatura, você define o ciclo e a plataforma programa as novas cobranças automaticamente.
POST /api/v1/bank/wallet/payment-link/
{
"type": "pix",
"billing_type": "subscription",
"cycle": "monthly",
"amount_in_cents": 4900,
"merchant": { "name": "Academia Fit" }
}Checkout combinado (Pix + cartão)
Nas áreas de alto ticket, o cliente quer escolher. Com o checkout combinado, você apresenta as opções de meios na mesma sessão e a plataforma resolve o restante: QR Pix, redenção de cartão, 3DS quando necessário e confirmação via webhook.
Onde funciona
- Crie o payment link na API ou no console.
- Compartilhe a URL por e-mail, WhatsApp, redes sociais ou documento.
- O cliente paga na página hospedada pela plataforma.
- Você é notificado pelo webhook e consulta o status na API.