> ## 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 16, 2026 - Modalidades de 3DS e roteamento da PagBank

> Erros de elegibilidade para 3DS2 Malga e MPI externo, badge de 3DS nativo na tabela de provedores, escolha da API da PagBank pelos dados do comprador e testes de 3DS Malga no Sandbox.

Esta semana traz regras mais claras para cada modalidade de 3DS, a escolha automática da API da PagBank e novos recursos de teste no Sandbox.

## Novidades

### Erros de elegibilidade para 3DS2 Malga e MPI externo

A Malga agora verifica, antes de criar a cobrança, se algum provedor do merchant atende à modalidade de 3DS pedida. Quando nenhum atende, a API responde `400` com um destes códigos:

* `provider_not_configured_for_3ds2`: cobrança com `setupId` ou MPI externo sem provedor com `paymentTypes=3ds2_malga`.
* `provider_not_configured_for_required_capabilities`: cobrança com `setupId` ou MPI externo e `splitRules` sem um mesmo provedor com `3ds2_malga` e `split`.

Esses erros não consomem o `setupId` nem a chave de idempotência. Depois de ajustar o provedor, repita a mesma requisição. O 3DS nativo continua respondendo `404` quando falta provedor com `operation=3ds2`.

Veja [Principais erros](/documentations/3ds2-malga/3ds-malga/principais-erros) e [Modalidades de 3DS na Malga](/documentations/3ds2-malga/intro#modalidades-de-3ds-na-malga).

### Badge de 3DS nativo na tabela de provedores

A [tabela de provedores e meios de pagamento](/documentations/type-tables/payment-methods-by-providers) agora mostra **3DS nativo** e **3DS2 Malga** como capacidades separadas. Um provedor com `3ds2_malga` não atende ao [3DS nativo](/documentations/3dsecure2-adyen/intro), e `operation=3ds2` não atende ao 3DS2 Malga nem ao MPI externo.

## Atualizações

### Escolha da API da PagBank pelos dados do comprador

No cartão de crédito com PagSeguro, a Malga envia a cobrança para a API de Orders da PagBank quando ela traz nome, e-mail e CPF ou CNPJ do comprador. Sem algum desses dados, a cobrança vai para a API de Charges. Os dados vêm do `customerId` ou de `fraudAnalysis.customer`.

Para usar a API recomendada pela PagBank, envie os três dados em toda cobrança. Veja [PagSeguro](/documentations/providers/pagseguro).

### Testes de 3DS Malga no Sandbox

No Sandbox, a cobrança com 3DS Malga é aprovada ou recusada pelo resultado da autenticação, com os cartões de teste da Cybersource. A regra do último dígito do cartão não vale quando a autenticação é bem-sucedida, e o antifraude não é executado. Veja [Testando 3DS Malga no Sandbox](/documentations/3ds2-malga/3ds-malga/testes-sandbox).

> [!TIP]
>
> Principais novidades:
>
> <ul>
>   <li>Novos erros `400` de elegibilidade para 3DS2 Malga e MPI externo, sem consumir o `setupId`.</li>
>   <li>Badges separados de 3DS nativo e 3DS2 Malga na tabela de provedores.</li>
>   <li>API da PagBank escolhida pelos dados do comprador.</li>
>   <li>Cartões de teste da Cybersource para 3DS Malga no Sandbox.</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)
- [Webhooks v1.1: notificações de eventos da Malga](/documentations/webhooks/webhook1-1.md)
- [Mais releases](/release-notes/releases.md)
- [PagSeguro](/documentations/providers/pagseguro.md)


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