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

# Testando 3DS Malga no Sandbox

> Como testar 3DS Malga no Sandbox: cartões de teste da Cybersource para sucesso sem fricção e com desafio, portador FAILED, regra do CVV e comportamento do antifraude.

No Sandbox, a cobrança com 3DS Malga é aprovada ou recusada pelo **resultado da autenticação** retornado pela Cybersource. Quando a autenticação é bem-sucedida, a [regra do último dígito do cartão](/documentations/welcome/testing) **não** se aplica.

## Como o Sandbox decide

Em cobranças com `threeDSecure2.setupId`, o resultado da autenticação define a cobrança:

| Resultado da autenticação | Cobrança |
| - | - |
| `transStatus` `Y` ou `A` e ECI diferente de `00` e `07` | Aprovada: `authorized` (com captura) ou `pre_authorized` |
| `transStatus` `Y` ou `A` com ECI `00` ou `07` | `threedsAuthenticated` falso; o Sandbox aplica a [regra do último dígito](/documentations/welcome/testing) |
| Autenticação sem sucesso ou indisponível (ex.: `4456530000001013`, `4456530000001039`) | `failed` já na etapa `3DS_authentication_enroll`, com o `declinedCode` da autenticação; a cobrança não chega à autorização |

<Info>
  Valem também as regras das seções seguintes: portador `FAILED`, CVV
  terminado em `0` e ausência de antifraude.
</Info>

## Cartões de teste da Cybersource

Use os cartões de teste oficiais da Cybersource para gerar o resultado de autenticação desejado. Os números abaixo vêm da página [Test Cases for 3D Secure 2.x](https://developer.cybersource.com/library/documentation/dev_guides/Payer_Authentication_SCMP_API/html/Topics/Test_Cases_for_3D_Secure_2_x.htm) da Cybersource, que lista também os demais cenários (falha, tentativa, indisponibilidade) e as demais bandeiras.

### Sucesso sem fricção

A autenticação termina sem desafio ao portador (`PARes` `Y`).

| Bandeira | Número do cartão | ECI / indicador de coleta |
| - | - | - |
| Visa | `4456530000001005` | 05 |
| Mastercard | `5200000000001005` | 2 |

### Sucesso com desafio

O portador recebe o desafio e, ao concluí-lo, a autenticação é bem-sucedida (`PARes` `Y`).

| Bandeira | Número do cartão | ECI / indicador de coleta |
| - | - | - |
| Visa | `4456530000001096` | 05 |
| Mastercard | `5200000000001096` | 2 |

<Note>
  A Cybersource recomenda validade em **janeiro do ano atual mais três** (em
  2026, `01/2029`), mas outras validades futuras também funcionam no Sandbox.
  Informe o número sem espaços.
</Note>

### Cartões legados

O Sandbox mantém uma lista fixa de cartões que sempre têm a autenticação aprovada em cobranças 3DS Malga, independentemente do resultado enviado:

* `4000000000002503`
* `4000000000001000`
* `4000000000002719`

## Forçar falha com o portador `FAILED`

Para forçar a falha de uma cobrança que seria aprovada, informe `FAILED` como nome do portador do cartão. Vale para os cartões legados e para cobranças com autenticação bem-sucedida.

## CVV

O CVV precisa **terminar em `0`**. Com qualquer outro final, o Sandbox retorna o CVV como não validado, mesmo que a autenticação seja bem-sucedida.

## Antifraude

O antifraude **não é executado** em cobranças 3DS Malga. A [regra de antifraude do Sandbox](/documentations/welcome/testing#antifraude), baseada no final do documento, não se aplica a elas.


## Related topics

- [Guia de teste](/documentations/welcome/testing.md)
- [Webhooks v1.1: notificações de eventos da Malga](/documentations/webhooks/webhook1-1.md)
- [Pagamentos instantâneos com Pix na Malga](/documentations/payment-methods/pix.md)
- [Sobre as APIs da Malga](/api-reference/about-apis.md)


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