> ## Documentation Index
> Fetch the complete documentation index at: https://docs.malga.io/llms.txt
> Use this file to discover all available pages before exploring further.

> ## Agent Instructions
> Responda em português brasileiro, na segunda pessoa ("você"), com base na documentação Malga.
> Não invente endpoints, parâmetros, status codes ou comportamentos de API. Se não estiver na docs, diga que não encontrou e indique a página mais próxima.
> Use os headers X-Client-Id e X-Api-Key nos exemplos de autenticação.
> Motor de Assinaturas refere-se a /v1/subscriptions* (cycles, trial, retentativas, webhooks subscription.*). Não chame de "motor de recorrência".
> Recorrência (provedor) é paymentMethod.recurrence em POST /v1/charges (initial / subsequent / unscheduled), distinto do Motor de Assinaturas.
> Sandbox é ambiente de testes e não afeta produção.

# Set 30, 2026 - Múltiplos cartões no Link de Pagamento

> Crie links de pagamento com o valor da venda dividido entre 2 ou 3 cartões de crédito.

export const AuthorProfile = ({author}) => <div className="flex flex-row gap-3 items-center">
    {author.image && <img src={author.image} alt={author.name} className="w-10 h-10 rounded-full m-0" />}
    <div>
      <a href={author.url}>{author.name}</a>
      <br />
      <span>{author.title}</span>
    </div>
  </div>;

export const andre = {
  name: "André Campos",
  title: "Software Engineer",
  url: "https://github.com/ATCamposs",
  image: "https://github.com/ATCamposs.png"
};

export const milena = {
  name: "Mila",
  title: "Software Engineer",
  url: "https://github.com/milenacrios",
  image: "https://avatars.githubusercontent.com/u/64020657?v=4"
};

<div className="flex flex-row gap-4">
  <AuthorProfile author={milena} />

  <AuthorProfile author={andre} />
</div>

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.

* **Dashboard:** veja [Criando Links via Dashboard](/documentations/payment-link/create-link-using-dashboard).
* **API:** inclua em `paymentMethods` um item com `paymentType: "multiple"`. Veja [Criando Links via API](/documentations/payment-link/create-link-using-api).

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)](/documentations/payment-link/intro), 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](/api-reference/sessions/pagar-uma-sessao).

No link de pagamento, o pagador escolhe **Combinar cartões de crédito**:

<Frame>
  <img alt="Checkout com a opção Combinar cartões de crédito" lightAlt="Checkout com a opção Combinar cartões de crédito" darkAlt="Checkout com a opção Combinar cartões de crédito" src="https://mintcdn.com/malga/P7v8TiBDPTpB8LMJ/assets/images/release/2026-09-30/multiple-light.png?fit=max&auto=format&n=P7v8TiBDPTpB8LMJ&q=85&s=7e4e0498126ed20189f289d72eeff794" className="dark:hidden" width="1280" height="823" data-path="assets/images/release/2026-09-30/multiple-light.png" />

  <img alt="Checkout com a opção Combinar cartões de crédito" lightAlt="Checkout com a opção Combinar cartões de crédito" darkAlt="Checkout com a opção Combinar cartões de crédito" src="https://mintcdn.com/malga/P7v8TiBDPTpB8LMJ/assets/images/release/2026-09-30/multiple-dark.png?fit=max&auto=format&n=P7v8TiBDPTpB8LMJ&q=85&s=183c830f79598ae6e6f8d322566dd35f" className="hidden dark:block" width="1280" height="823" data-path="assets/images/release/2026-09-30/multiple-dark.png" />
</Frame>

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.

<Frame>
  <img alt="Checkout com o preenchimento de cada cartão" lightAlt="Checkout com o preenchimento de cada cartão" darkAlt="Checkout com o preenchimento de cada cartão" src="https://mintcdn.com/malga/P7v8TiBDPTpB8LMJ/assets/images/release/2026-09-30/multiple-tabs-light.png?fit=max&auto=format&n=P7v8TiBDPTpB8LMJ&q=85&s=80200dc336f693d33687c47a9ff44969" className="dark:hidden" width="1280" height="1242" data-path="assets/images/release/2026-09-30/multiple-tabs-light.png" />

  <img alt="Checkout com o preenchimento de cada cartão" lightAlt="Checkout com o preenchimento de cada cartão" darkAlt="Checkout com o preenchimento de cada cartão" src="https://mintcdn.com/malga/P7v8TiBDPTpB8LMJ/assets/images/release/2026-09-30/multiple-tabs-dark.png?fit=max&auto=format&n=P7v8TiBDPTpB8LMJ&q=85&s=27ad7ea6c2fcf915c73f8028790216f0" className="hidden dark:block" width="1280" height="1242" data-path="assets/images/release/2026-09-30/multiple-tabs-dark.png" />
</Frame>

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.

| Evento | Quando chega |
| - | - |
| `purchase.created` | A venda foi criada e a autorização foi enfileirada |
| `purchase.charge_authorized` | Uma cobrança da venda foi autorizada |
| `purchase.pre_authorized` | Todas as cobranças estão pré-autorizadas e a venda segue pendente |
| `purchase.paid` | A venda foi paga |
| `purchase.failed` | A venda falhou por recusa ou abandono de uma cobrança |
| `purchase.cancelled` | A venda foi cancelada |
| `purchase.void_failed` | O estorno das cobranças da venda esgotou as tentativas ou terminou com uma cobrança ainda retida |

<Warning>
  O evento de cancelamento é `purchase.cancelled`, com dois "L". Ao cadastrar o webhook, use exatamente essa grafia.
</Warning>

Veja todos os eventos no [guia de webhooks](/documentations/webhooks/webhook1-1#eventos-purchase).

<Tip>
  Principais novidades:

  <ul>
    <li>Novo método **Múltiplos cartões** no Link de Pagamento, com 2 ou 3 cartões.</li>
    <li>Configuração na Dashboard ou via API: quantidade máxima de cartões e de parcelas.</li>
    <li>Link com divisão do valor e autorização de cada cartão.</li>
    <li>Sete novos eventos de webhook `purchase.*` para acompanhar a venda com múltiplos cartões.</li>
  </ul>
</Tip>

<Info> Ficou com dúvida? Fale com a gente pelo e-mail [suporte@malga.io](mailto:suporte@malga.io).</Info>


## Related topics

- [Abr 29, 2026 - Split no Link de Pagamento](/release-notes/2026-04-29-Release-Notes.md)
- [July 13, 2026 - Antifraude no link de pagamento](/release-notes/2026-07-13-Release-Notes.md)
- [Múltiplos cartões](/documentations/payment-methods/multiple-cards.md)
- [Set 22, 2026 - Planos de venda no provedor Malga](/release-notes/2026-09-22-Release-Notes.md)