> ## 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.

# Out 21, 2026 - Mais de um cartão no Tokenization SDK

> O Tokenization SDK passa a tokenizar dois ou mais cartões na mesma página, com uma instância de MalgaTokenization para cada cartão.

![Mila](https://avatars.githubusercontent.com/u/64020657?v=4)

[Mila](https://github.com/milenacrios)

Software Engineer

O [Tokenization SDK](/sdks/tokenization/v2/multiple-cards) agora permite tokenizar vários cartões na mesma página, o que viabiliza fluxos como o pagamento dividido entre múltiplos cartões no checkout.

## Melhorias

### Múltiplos cartões na mesma página

* Crie uma instância de `MalgaTokenization` para cada cartão. Cada instância tem os próprios campos, eventos e token.
* O `container` de cada campo aceita qualquer `id`, desde que seja único na página. Antes, só eram aceitos `card-number`, `card-holder-name`, `card-cvv` e `card-expiration-date`.
* Os eventos registrados com `on` em uma instância recebem apenas os eventos dos campos daquele cartão.

```html theme={null}
<div id="card-number-1"></div>
<div id="card-holder-name-1"></div>
<div id="card-cvv-1"></div>
<div id="card-expiration-date-1"></div>

<div id="card-number-2"></div>
<div id="card-holder-name-2"></div>
<div id="card-cvv-2"></div>
<div id="card-expiration-date-2"></div>
```

```typescript theme={null}
const firstCard = new MalgaTokenization({
  apiKey: 'YOUR_API_KEY',
  clientId: 'YOUR_CLIENT_ID',
  options: {
    sandbox: true,
    config: {
      fields: {
        cardNumber: { container: 'card-number-1' },
        cardHolderName: { container: 'card-holder-name-1' },
        cardCvv: { container: 'card-cvv-1' },
        cardExpirationDate: { container: 'card-expiration-date-1' },
      },
    },
  },
})

const secondCard = new MalgaTokenization({
  apiKey: 'YOUR_API_KEY',
  clientId: 'YOUR_CLIENT_ID',
  options: {
    sandbox: true,
    config: {
      fields: {
        cardNumber: { container: 'card-number-2' },
        cardHolderName: { container: 'card-holder-name-2' },
        cardCvv: { container: 'card-cvv-2' },
        cardExpirationDate: { container: 'card-expiration-date-2' },
      },
    },
  },
})

const [first, second] = await Promise.all([
  firstCard.tokenize(),
  secondCard.tokenize(),
])
```

> [!WARNING]
>
> Não repita o mesmo `container` em duas instâncias. Um `id` repetido faz os dados de um cartão se misturarem com os do outro.

Veja o passo a passo em [Múltiplos cartões](/sdks/tokenization/v2/multiple-cards).

> [!TIP]
>
> Principais novidades:
>
> <ul>
>   <li>Tokenização de dois ou mais cartões na mesma página, com uma instância de `MalgaTokenization` por cartão.</li>
>   <li>`container` aceita qualquer `id` único na página.</li>
>   <li>Novo evento `loading`, disparado no início e no fim da tokenização. Veja [Eventos](/sdks/tokenization/v2/events).</li>
> </ul>

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


## Related topics

- [Pagamentos com cartão de crédito na Malga](/documentations/payment-methods/credit-card.md)
- [Tokenizando mais de um cartão](/sdks/tokenization/v2/multiple-cards.md)
- [Out 19, 2026 - Repasses e recebíveis no Dashboard](/release-notes/2026-10-19-Release-Notes.md)
- [Mais releases](/release-notes/releases.md)


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.