Para os casos em que a transação é autenticada, o objeto authentication é obrigatório. Ele possui os seguintes campos:

typestringIndica o tipo de autenticação utilizado. Atualmente o único tipo suportado é threed_secure
threed_secureobjectIndica os campos a serem enviados para a autenticação 3DS.

Por fim, o objeto threed_secure contém os seguintes campos:

AtributosTipoTamanho MáximoDescriçãoObrigatório
mpistring11Indica quem é o autenticador da transação. Pode receber os valores "acquirer" para transações autenticadas pela adquirente ou "third_party" para autenticadores externos.Sim
ecistring2Indica o resultado da tentativa de autenticação. Obrigatório quando o mpi é "third_party".Sim
cavvstring256Código de autenticação do dono do cartão. Obrigatório quando o mpi é "third_party".Sim
transaction_idstring256id da transação no autenticador. Obrigatório quando o mpi é "third_party".Não
ds_transaction_idstring256Identificador da transação no Directory ServiceSim
versionstring6Versão do 3DS. Quando não enviado, entende-se que a versão é a 1.0.Não
redirect_urlstring512Url de redirecionamento quando a transação é aprovada pelo autenticador. Obrigatório quando o mpié "acquirer".Não

📘

Autenticação 3DS

Quando a autenticação é feita por um autenticador do tipo acquirer, só é necessário enviar os campos mpi e redirect_url. Os campos mpi, eci, cavv e transaction_id são os necessários para uma transação com autenticação externa.