Skip to main content
O link de pagamento é um checkout que aceita vários pagamentos. Você cria uma vez, compartilha onde quiser e cada cliente que abrir o link faz o próprio pagamento, por Pix, cartão de crédito ou boleto. O vídeo também está em Link de pagamento. Use o link quando o mesmo valor vai ser pago por muitas pessoas: inscrições, doações, uma venda divulgada no WhatsApp ou no Instagram. Para cobrar um pedido específico, uma vez, use o checkout. No dashboard, os dois ficam em telas diferentes: o link em Sua Loja → Links de pagamento e o checkout em Sua Loja → Cobranças. O link nasce Ativo (ACTIVE) e aceita pagamentos até você desativá-lo. Cada pagamento aparece dentro do link no dashboard e gera um webhook checkout.completed. Desativado (CANCELLED), o link para de abrir e não aceita novos pagamentos. Os pagamentos que já entraram continuam no dashboard.

​
Regras

  • Mesmas regras do checkout. Valor mínimo, itens, cupons, idempotência por externalId, URLs de finalização e de retorno e as flags skip_customer e skip_address funcionam como no checkout.
  • Sem cliente fixo. Cada cliente preenche os próprios dados na página. Mandar customerId dá erro: You cannot pass a customer for a checkout with multiple payments frequency.
  • Sem Apple Pay e Google Pay. As carteiras só valem no checkout. Mandar APPLE_PAY ou GOOGLE_PAY em methods dá erro: Apple Pay and Google Pay are only available for one-time checkouts.
  • Sem upsell. A oferta de upsell depois da compra só existe no checkout.
  • Parcelamento e repasse de taxa. O link aceita card.maxInstallments e card.passFeesToCustomer, como o checkout. Veja Parcelamento no cartão e Repasse de taxa.
  • Boleto. dueDate, interest e fine exigem BOLETO em methods. Veja Boleto.
  • Sem prazo de validade. O link não expira. Ele fica ativo até você desativá-lo.
  • paidAmount fica null. O link não acumula o total recebido. Para acompanhar os pagamentos, use o dashboard ou os webhooks.
  • Cupom de 100%. Quando um cliente fecha a compra com um cupom que zera o valor, o link continua ACTIVE para os próximos.
1

Abra os links de pagamento

No menu, vá em Sua Loja → Links de pagamento e clique em Criar link de pagamento.
2

Preencha o link

  • Produtos: os produtos avulsos da loja. Cada produto entra com quantidade 1.
  • Métodos de pagamento: Pix, cartão ou boleto, conforme o que a sua conta tem liberado.
  • Parcelas no cartão e Repassar a taxa do cartão ao cliente: aparecem quando a sua conta tem esses recursos.
  • Cupons (opcional).
  • URL de finalização (opcional): para onde o cliente vai depois de pagar.
  • URL de retorno (opcional): para onde ele volta se desistir.
Clique em Cadastrar.
3

Compartilhe o link

Abra o link na lista e copie a URL. Ela tem o formato https://app.abacatepay.com/pay/bill_....
4

Acompanhe os pagamentos

Na tela do link, você vê Total arrecadado (bruto), Total de compradores e a lista de pagamentos. Ali também dá para editar os métodos de pagamento e os cupons, e desativar ou ativar o link pelo botão ao lado do status.
1

Crie uma chave de API

Em Integração → API, crie uma chave com a permissão CHECKOUT:CREATE. Veja Chaves de API.
2

Crie o link

O corpo é o mesmo do checkout, sem customerId e sem upSellProductId. A rota já cria o link: não mande frequency. A resposta traz status: "ACTIVE", frequency: "MULTIPLE_PAYMENTS" e a url para compartilhar.
3

Receba os pagamentos

Cada pagamento gera um checkout.completed. Grave o id de cada evento para não processar o mesmo pagamento duas vezes.
As rotas de checkout (/checkouts/get e /checkouts/list) não trazem links de pagamento.

​
Notificações

Cada pagamento do link gera um checkout.completed, com checkout.frequency: "MULTIPLE_PAYMENTS" e checkout.status: "ACTIVE". O checkout.amount do evento é o valor daquele pagamento: para saber quanto o link arrecadou, some os eventos. Reembolsos e disputas dos pagamentos do link chegam pelos mesmos eventos do checkout. Veja Eventos de checkout e Webhooks.

​
Testar no Modo Teste

Crie o link com o Modo Teste ligado ou com uma chave abc_dev_. Abra o link e clique em Simular Pagamento, o botão final da página. Repita quantas vezes quiser: cada simulação conta como um pagamento novo do link.

​
Perguntas frequentes

Não. Para cobrar um cliente específico, crie um checkout com customerId.