Para os casos em que a transação é autenticada, o objeto authentication
é obrigatório. Ele possui os seguintes campos:
type | string | Indica o tipo de autenticação utilizado. Atualmente o único tipo suportado é threed_secure |
threed_secure | object | Indica os campos a serem enviados para a autenticação 3DS. |
Por fim, o objeto threed_secure
contém os seguintes campos:
Atributos | Tipo | Tamanho Máximo | Descrição | Obrigatório |
---|---|---|---|---|
mpi | string | 11 | Indica quem é o autenticador da transação. Pode receber os valores "acquirer" para transações autenticadas pela adquirente ou "third_party" para autenticadores externos. | Sim |
eci | string | 2 | Indica o resultado da tentativa de autenticação. Obrigatório quando o mpi é "third_party". | Sim |
cavv | string | 256 | Código de autenticação do dono do cartão. Obrigatório quando o mpi é "third_party". | Sim |
transaction_id | string | 256 | id da transação no autenticador. Obrigatório quando o mpi é "third_party". | Não |
ds_transaction_id | string | 256 | Identificador da transação no Directory Service | Sim |
version | string | 6 | Versão do 3DS. Quando não enviado, entende-se que a versão é a 1.0. | Não |
redirect_url | string | 512 | Url 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 camposmpi
eredirect_url
. Os camposmpi
,eci
,cavv
etransaction_id
são os necessários para uma transação com autenticação externa.