Como Utilizar
Para a utilização de 3DS teremos de fazer as seguintes mudanças no envio de requisições.
Authentication Method <AuthntcnMtd>
<AuthntcnMtd>
Indica o método utilizado para autenticar o cardholder.
Os valores possíveis para esta TAG são:
Valor | Descrição |
---|---|
TDSC | Utilizado método de autenticação 3D Secure. |
INAP | Utilizado método de autenticação InApp. |
Authentication Value <AuthntcnVal>
<AuthntcnVal>
Neste campo deve ser enviado o criptograma de autenticação (CAVV ou TAVV).
Authentication Result <AuthntcnRslt>
<AuthntcnRslt>
Indica o resultado da autenticação.
Os valores possíveis para esta TAG são:
Valor | Descrição |
---|---|
CRPT | Indica que houve uma autenticação com sucesso e que o criptograma será enviado. |
DENY | Indica que a transação não foi autenticada. |
AUTH | Indica que houve uma tentativa de autenticação e o emissor não suporta o protocolo. |
UCRP | Indica que houve uma autenticação com sucesso sem a participação do emissor (Data Only) |
Transações com tentativas de autenticação sem sucesso devem conter as informações do protocolo 3DS
Para as transações que tiverem tentativa de autenticação sem sucesso o request deve conter a informação de modo de autenciação 3DS (<AuthntcnMtd>TDSC) e indicar no resultado da autenticação que não foi autenticada (DENY ou AUTH). Caso não haja essa indicação, para algumas bandeiras, informamos no ECI (Electronic Commerce Indicator) que não houve tentativa de autnticação, o que pode influenciar na conversão de alguns emissores.
3D Secure <TdScre>
<TdScre>
Para autenticação do tipo 3D Secure os campos adicionais abaixo devem ser enviados dentro do container TdScre.
Transaction ID <TxId>
<TxId>
O ID da transação gerado pelo servidor de autenticação 3D Secure.
Apenas para 3D Secure versão 2.
Versão <TdScreVrsn>
<TdScreVrsn>
Indica qual a versão do 3D Secure utilizada para autenticar o Cardholder.
Valor | Descrição |
---|---|
VRS21 | 3D Secure 2.1 |
VRS22 | 3D Secure 2.2 |
VRS23 | 3D Secure 2.3 |
VRS24 | 3D Secure 2.4 |
VRS25 | 3D Secure 2.5 |
VRS26 | 3D Secure 2.6 |
VRS27 | 3D Secure 2.7 |
VRS28 | 3D Secure 2.8 |
VRS29 | 3D Secure 2.9 |
Transaction Status Indicator <TxSts>
<TxSts>
Indica o estado da verificação/autenticação.
Valor | Descrição |
---|---|
Y | Verificação de autenticação bem-sucedida. |
N | Não autenticado / Conta não confirmada. |
A | Indica que foram realizadas tentativas de autenticação/verificação. A transação não foi autenticada/verificada, porém é fornecida uma prova de tentativa. |
I | Apenas informativo. Indica que o ACS reconhece a preferência do solicitante do 3DS de não contestar a transação, pois os dados enviados foram apenas para fins informativos. |
O que é ACS?
O Access Control Server é um componente que opera no Domínio do Emissor, que verifica se a autenticação está disponível para um número de cartão e tipo de dispositivo, e autentica portadores de cartão específicos.
Exemplo
Abaixo temos alguns exemplos do envio das tags indicadas acima
Exemplo de Mensagem de Autenticação 3DS com Sucesso:
<Authntcn>
<AuthntcnMtd>TDSC</AuthntcnMtd>
<AuthntcnVal>12341234123412341234</AuthntcnVal>
<AuthntcnRslt>CRPT</AuthntcnRslt>
<TdScre>
<TxId>1234123412341234</TxId>
<TxSts>Y</TxSts>
<TdScreVrsn>VRS21</TdScreVrsn>
</TdScre>
</Authntcn>