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

CicloIntervalo
weeklySemanal
biweeklyQuinzenal
monthlyMensal
quarterlyTrimestral
semiannuallySemestral
yearlyAnual

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

  1. Crie o payment link na API ou no console.
  2. Compartilhe a URL por e-mail, WhatsApp, redes sociais ou documento.
  3. O cliente paga na página hospedada pela plataforma.
  4. Você é notificado pelo webhook e consulta o status na API.