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 11 days ago