| Termo | Definição |
|---|---|
| 3-D Secure (3DS) | Protocolo de autenticação para transações online que envolve três domínios (emissor, adquirente/lojista e interoperabilidade). |
| 3DS nativo | Modalidade em que a cobrança envia threeDSecure2 sem setupId, MPI externo ou Data Only. Exige provedor com operation=3ds2; essa capacidade não é substituída por paymentTypes=3ds2_malga. |
| 3DS2 Malga | Modalidade identificada por threeDSecure2.setupId. Exige provedor com paymentTypes=3ds2_malga, sem exigir operation=3ds2. |
| 3DS Server | Servidor (lado PSP/lojista) que forma e assina as mensagens 3DS, interagindo com o DS e o ACS. |
| ACS (Access Control Server) | Servidor mantido pelo banco emissor responsável por autenticar o portador durante o desafio. |
| AcsTransactionId | UUID atribuído pelo ACS para a transação (challenge). |
| AReq / ARes | Mensagens de autenticação da versão EMV 3DS (substituem PAReq/PARes). |
| BIN | Bank Identification Number do adquirente, associado à bandeira. |
| CAVV | Cardholder Authentication Verification Value – código criptográfico gerado pelo emissor que comprova a autenticação. |
| Challenge Flow | Fluxo em que o emissor solicita uma ação extra (OTP, biometria, etc.); iniciado com stepUrl + token. |
| Collect URL | Endpoint do provedor para onde o front-end envia o JWT e coleta dados de dispositivo na etapa data collection. |
| Data Collection | Fase em que o navegador envia dados do dispositivo ao provedor via collectUrl, geralmente em iframe invisível. |
| Data Only | Modalidade identificada por threeDSecure2.dataOnly: true sem setupId. Segue o roteamento de crédito e não exige operation=3ds2 nem paymentTypes=3ds2_malga. Se houver setupId, prevalece a modalidade 3DS2 Malga. |
| DirectoryServerTransactionId | UUID atribuído pelo DS para a transação. |
| DS (Directory Server) | Componente que verifica se cartão, emissor e comerciante participam do 3DS e encaminha mensagens entre 3DS Server e ACS. |
| ECI | Electronic Commerce Indicator; valor que indica nível de autenticação e se há transferência de responsabilidade. |
| EMV 3-D Secure (3DS2) | Evolução do 3DS, definida pela EMVCo, que envia mais dados contextuais ao emissor e permite fluxos frictionless ou challenge. |
| EMVCo | Organização que mantém o padrão EMV 3DS e outras especificações de pagamento. |
| Frictionless Flow | Autenticação 3DS aprovada sem interação adicional do cliente. |
| JWT / Token | JSON Web Token devolvido no setup; é reenviado ao provedor na coleta e no challenge. |
| Liability shift | Transferência de responsabilidade por fraude do lojista para o emissor quando o 3DS é bem-sucedido. Quando usado MPI externo, a autenticação é de responsabilidade do parceiro, portanto devolveremos false para essa propriedade. |
| MCC | Merchant Category Code – código da atividade comercial. |
| MPI (Merchant Plug-In) | Módulo que integra o merchant ao 3DS (normalmente embutido no 3DS Server ou no PSP). |
| MPI externo | Modalidade que envia dados de autenticação em threeDSecure2.mpi, sem Data Only. Exige provedor com paymentTypes=3ds2_malga, sem exigir operation=3ds2. |
| operation | Eixo de capacidade de operação do provedor. No contexto 3DS, operation=3ds2 identifica suporte ao 3DS nativo e operation=split identifica suporte a split. |
| PAReq / PARes | Mensagens Payer Authentication Request/Response da especificação 3DS 1.x. |
| paymentTypes | Eixo de capacidade por tipo de pagamento do provedor. O valor 3ds2_malga identifica suporte à autorização de cobranças com setupId ou MPI externo. |
| Capacidades simultâneas | Quando 3DS2 Malga ou MPI externo é combinado com split, o mesmo provedor precisa ter paymentTypes=3ds2_malga e operation=split. A ausência dessa interseção rejeita a cobrança. Essa regra não se aplica ao 3DS nativo com split. |
| Redirect URL | Endereço do seu site para o qual o cliente volta após o desafio. |
| RequiresLiabilityShift | Flag na Malga que exige liabilityShift=true para aprovar a cobrança. |
| Setup ID | Identificador da sessão criada no setup 3DS2; vincula coleta de dados e cobrança. |
| StepUrl | URL do ACS para exibir a tela de desafio dentro de um iframe ou redirecionamento. |
| ThreeDSServerTransactionId | UUID gerado pelo 3DS Server para rastrear a transação. |
| TransStatus | Código de resultado da autenticação (ex.: Y = Sucesso, N = Falha, C = Challenge). |
| UCAF | Universal Cardholder Authentication Field – padrão de autenticação Mastercard. |
| VEReq / VERes | Mensagens de verificação de enrolamento na versão 1.x (Visa). |
| XID | Identificador de transação 3DS original (versão 1) ou adicional para algumas bandeiras. |
3DS2 - Malga
Glossário 3DS
Was this page helpful?