Autenticação Externa de Cartão (3DS)
Como forma de melhorar a segurança e a experiência do usuário, oferecemos a possibilidade de utilizar o processo de autenticação 3DS (Three-Domain Secure) para transações com cartão de crédito.
Para isso, é necessário incluir os campos Cavv, Xid, Eci, Version e ReferenceID no objeto payment_info. Esses campos são gerados pelo seu provedor de autenticação 3DS e devem ser fornecidos junto com as informações do cartão de crédito.
Exemplo de Autenticação Externa de Cartão (3DS)
"payment_info": {
"cvv": "123",
"card_holder": "João da Silva",
"card_number": "4000000000001000",
"installments": 2,
"expiration_date": "12/2037",
"holder_document": "22555666589",
"Cavv": "AAABB2gHA1B5EFNjWQcDAAAAAAB=",
"Xid": "Uk5ZanBHcWw2RjRCbEN5dGtiMTB=",
"Eci": ,
"Version": "2",
"ReferenceID": "a24a5d87-b1a1-4aef-a37b-2f30b91274e6"
}
| Campo | Descrição | Tipo | Tamanho | Obrigatório |
|---|---|---|---|---|
payment_info.Cavv | Assinatura retornada nos cenários de sucesso na autenticação. | texto | - | ⚠️ Obrigatório para transações autenticadas pelo emissor/bandeira ou autorizações com Data Only |
payment_info.Xid | XID retornado no processo de autenticação. | texto | - | Não |
| - O Xid não é retornado em todas as autenticações. | ||||
| - O envio é recomendado caso o Xid tenha sido retornado no script. | ||||
payment_info.Eci | Electronic Commerce Indicator retornado no processo de autenticação. | número | 1 posição | Sim |
payment_info.Version | Versão do 3DS aplicado no processo de autenticação. | alfanumérico | 5 posições | Obrigatório para transações com autenticação 3DS |
| Valores possíveis: | ||||
| - Visa e Mastercard: "2.2.0" | ||||
| - Elo e Amex: "2.1.0" | ||||
payment_info.ReferenceID | RequestID retornado no processo de autenticação. | GUID | 36 posições | Não |
| - O ReferenceId não é retornado em todas as autenticações. | ||||
| - O envio é recomendado caso o ReferenceId tenha sido retornado no script. |
Updated 5 months ago