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"
}
CampoDescriçãoTipoTamanhoObrigatório
payment_info.CavvAssinatura 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.XidXID 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.EciElectronic Commerce Indicator retornado no processo de autenticação.número1 posiçãoSim
payment_info.VersionVersão do 3DS aplicado no processo de autenticação.alfanumérico5 posiçõesObrigató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.ReferenceIDRequestID retornado no processo de autenticação.GUID36 posiçõesNão
- O ReferenceId não é retornado em todas as autenticações.
- O envio é recomendado caso o ReferenceId tenha sido retornado no script.