Skip to main content
O Link de Pagamento agora aceita o método múltiplos cartões. O pagador pode dividir o valor da venda entre 2 ou 3 cartões de crédito em uma única compra.

Como gerar

Crie o link pela Dashboard ou via API. Você define a quantidade máxima de cartões (2 ou 3) e o limite de parcelas por cartão. O método fica disponível para subcontas com crédito habilitado. Você pode oferecê-lo junto com Pix, Boleto e cartão de crédito único. Em links com múltiplos pagamentos (1:N), o método também está disponível.

Como o cliente paga

Em integrações via sessão, envie o ID da sessão no header e um paymentMethod com type: "multiple", com os dados de cada cartão em paymentSource. Saiba mais em Pagar uma sessão. No link de pagamento, o pagador escolhe Combinar cartões de crédito:
Checkout com a opção Combinar cartões de créditoCheckout com a opção Combinar cartões de crédito
  1. Se o link permitir até 3 cartões, ele escolhe pagar com 2 ou 3.
  2. Ajusta quanto cobra em cada cartão. O valor mínimo por cartão é R$ 1,00, e a soma precisa fechar o total do pedido.
  3. Preenche os dados e o parcelamento de cada cartão.
  4. Confirma o pagamento e acompanha a autorização de cada cartão na tela de processamento.
Checkout com o preenchimento de cada cartãoCheckout com o preenchimento de cada cartão
Se algum cartão for recusado, o checkout mostra o resultado por cartão e o pagador pode tentar novamente.

Eventos de webhook

Sete novos eventos purchase.* acompanham a venda com múltiplos cartões. Eles são enviados somente na versão 1.1 dos webhooks.
O evento de cancelamento é purchase.cancelled, com dois “L”. Ao cadastrar o webhook, use exatamente essa grafia.
Veja todos os eventos no guia de webhooks.

Atualização: limite de falhas no estorno

Quando o provedor recusa várias vezes o estorno de uma mesma cobrança, a Malga para de enviar novos pedidos de estorno ao provedor. O limite vale para a requisição de void em qualquer meio de pagamento. Nesses casos, a Malga não cria um novo transactionRequest e não altera o status da cobrança. Um estorno concluído com sucesso zera a contagem. Veja como tratar esses erros em Limite de falhas no estorno e na tabela de erros da API.
Principais novidades:
  • Novo método Múltiplos cartões no Link de Pagamento, com 2 ou 3 cartões.
  • Configuração na Dashboard ou via API: quantidade máxima de cartões e de parcelas.
  • Link com divisão do valor e autorização de cada cartão.
  • Sete novos eventos de webhook purchase.* para acompanhar a venda com múltiplos cartões.
  • Estornos com falhas repetidas no provedor recusados com 429 (aguarde retry_after_at) ou 422 (bloqueio definitivo).
Ficou com dúvida? Fale com a gente pelo e-mail suporte@malga.io.