threeDSRequest

O objeto threeDSRequest permite:

  • determinar se um pagamento for realizado com ou sem autenticação 3D Secure,
  • transmitir informações vinculadas ao 3D Secure.

Se nenhum valor for informado para este objeto, um pagamento sem autenticação 3D Secure será efetuado por padrão.

Os objetos e os atributos do objeto threeDSRequest mudam em função do tipo de pagamento.

  • Pagamento sem 3D Secure.

Um pagamento sem autenticação 3D Secure é uma operação de débito pela qual a autenticação do portador do cartão não é efetuada.

Somente um atributo deve obrigatoriamente ser enviado:

Atributo Formato
mode

Seleção do modo de autenticação 3D Secure.

DISABLED

Pagamento sem autenticação 3D Secure. Parâmetro utilizado por padrão se nenhum valor estiver informado.

string

Observação: todos os atributos não são levados em consideração para criar um pagamento sem 3D Secure.

  • Pagamento com 3D Secure.

    O pagamento com autenticação 3D Secure requer duas chamadas à operaçãocreatePayment.

    • Uma primeira chamada para verificar o alistamento do cartão e para resgatar as informações necessárias para redirecionar o comprador para o ACS.

      Somente um atributo deve obrigatoriamente ser enviado:

      Atributo Formato
      mode

      Seleção do modo de autenticação 3D Secure.

      ENABLED_CREATE

      Permite verificar o alistamento do cartão 3D Secure antes de efetuar o pagamento.

      string

      Observação: todos os atributos não são levados em consideração para criar um pagamento com3D Secure.

    • Uma segunda chamada para analisar o retorno do 3D Secure e finalizar a transação.

      Três atributos devem obrigatoriamente ser enviados:

      Atributo Formato
      mode

      Seleção do modo de autenticação 3D Secure.

      ENABLED_FINALIZE

      Permite finalizar um pagamento 3D Secure.

      string
      requestId

      Com o modo ENABLED_FINALIZE, este campo deve ter o valor retornado no atributo threeDSRequestId de l'objet threeDsResponse dans l' opération createPayment avec le mode ENABLED_CREATE.

      string
      pares

      Mensagem PaRes (Payer Authentication Response) reenviada pelo ACS.

      string

      Observação: todos os atributos não são levados em consideração para criar um pagamento com3D Secure.

  • Pagamento com autenticação 3D Secure realizado pelo MPI do Estabelecimento comercial

Diferentes atributos devem obrigatoriamente ser enviados para este tipo de pagamento.

Cuidado: um valor específico para um atributo pode resultar na valorização de um outro atributo!

Atributo Requisito Formato
mode

Seleção do modo de autenticação 3D Secure.

MERCHANT_3DS

Permite realizar um pagamento 3DS com o MPI do Estabelecimento comercial.

string
brand

Rede do cartão.

string
enrolled

Status de alistamento do portador. Os valores possíveis são:

  • Y para um status alistado.
  • N para um status não alistado.
  • U para um status desconhecido.
string
status

Status de autenticação do portador. Os valores possíveis são:

  • Y para um status autenticado 3 DS.
  • N para um erro de autenticação.
  • U para uma autenticação impossível.
  • A para uma tentativa de autenticação.

Se enrolled tem o valor Y

string
eci

Indicador de Comercio Eletrônico.

O valor eci depende do status da autenticação 3DS e do tipo de cartão. Os valores possíveis são:
  status =Y status = A status = U status =N
VISA - AMEX 05 06 07 -
MasterCard 02 01 - -

Se status tem o valor Y ou A

string
xid

Número de transação 3DS.

Se status tem o valor Y

string
cavv

Certificado do ACS.

Se status tem o valor Y ou A

string
algorithm

Algoritmo de verificação da autenticação do portador (CAVV). Os valores possíveis são:

  • 0 para HMAC.
  • 1 para CVV.
  • 2 para CVV_ATN.
  • 3 para Mastercard SPA.

Se status tem o valor Y ou A

string