• França
lyra.com
Procurando
Categoria
Tags
pagina inicial
Suporte técnico

Guia de integração

Caso de uso

.

  • Para a rede CB
  • Para o rede VISA / Mastercard / AMEX
  • Autenticação desligada

Autenticação 3D Secure v2

Teste

Teste o Web Service V4.1/PCI/Charge/CreatePayment em nosso playground.

Dados de autenticação

Recupere os seguintes dados:

Protocolo de autenticação

SOBRENOME Descrição
name Nome do protocolo de autenticação, com o valor THREEDS
VERSÃO Versão do protocolo de autenticação Valores possíveis:
  • 2
  • 2.1.0
  • 2.2.0
directoryServer Nome do servidor de diretório (DS) usado durante a autenticação. Valores possíveis:
  • Amex
  • CB
  • Diners
  • Discover
  • visa
  • mastercard
ChallengePreference Preferência 3DS enviada ao DS se a autenticação do portador for sucedida, com um status 'SUCCESS' ou 'ATTEMPT'.

O resultado do pagamento depende do status da autenticação.

  1. Se o status da autenticação tiver o valorSUCCESSouATTEMPT, recupere estas informações:
</tbody>
SOBRENOME Descrição
authenticationType Nome do protocolo de autenticação. Valor requerido:
  • CHALLENGE
  • FRICTIONLESS
authenticationValue Referência gerada pelo emissor para validar a integridade dos dados da transação. Conforme o Directory Server usado,
  • CAVV pour VISA
  • AAV pour Mastercard
  • AEVV pour AMEX Safekey.

Ex: +kAr/o8S0DxgGYkz7QQHZCw8V5k=

commerceIndicator Indicador de comercio eletrônico (ECI). Valor retornado pela ACS após a autenticação, em função do status da autenticação e do tipo de cartão.

Ex: 05

dsTransID Identificador exclusivo da transação gerada pelo DS 3DS2.

Ex : d6706a0d-c48d-4cf4-a1d2-d4a401a3143e

isenção Isenção aplicada. Necessário para FRICTIONLESS, valor do campo 'authenticationType'. Ver :Modo seletivo e isenções.

Ex: LOW_VALUE

requestorName O nome do EC usado para autenticar o portador.
acsTransID Identificador único de transação gerado pelo ACS.

Ex: d727ebfe-de4c-4682-85fa-e60ca00a9cff

authValueAlgorithm Algoritmo usado para verificar a autenticação do portador. Valores possíveis:
  • 0 pour HMAC
  • 1 pour CVV
  • 2 pour CVV_ATN
  • 3 pour MASTERCARD_SPA
  • A pour AV-CB
dsScore Pontuação de autenticação.

Exemplo: 31

  1. Se o status de autenticação falhar com os seguintes valores:
  • DISABLED
  • ENROLLED_UNAVAILABLE
  • FAILED
  • NOT_ENROLLED
  • UNAVAILABLE

Neste caso, recupere estas informações:

SOBRENOME Descrição
challengeCancelationIndicator Nome do protocolo de autenticação. Valor requerido: Indicador de cancelamento de challenge recebido na mensagem RReq. Valor retornado pelo DS no caso de cancelamento da autenticação.

Ex: 01

transactionStatusReason Motivo da falha de autenticação devolvida pelo DS em caso de falha de autenticação.

Ex: 82

Para a rede CB

Solicitação

Champs obligatoires
  • VALOR
  • Moeda

Dados do cartão

  • Tipo de meio de pagamento:CARDS
  • Número principal do cartão: pan.
  • Mês de vencimento.
  • Ano de vencimento.

Dados de autenticação

  1. No protocolo
  • sobrenome:THREEDS
  • número de versão
  • diretórioServer: CB
  • challengePreference: Ex: NO_CHALLENGE_REQUESTED em caso de sucesso na autenticação (statusSUCCESSouATTEMPT).
  1. Dados de teste
authValueAlgorithm : 2 authenticationType : FRICTIONLESS
authenticationValue : +kAr/o8S0DxgGYkz7QQHZCw8V5k= commerceIndicator : 05
challengePreference : NO_CHALLENGE_REQUESTED dsTransID : d6706a0d-c48d-4cf4-a1d2-d4a401a3143e
exemption : LOW_VALUE acsTransID : d727ebfe-de4c-4682-85fa-e60ca00a9cff
requestorName : DEMO STORE dsScore : 31

Exemplo de solicitação

/pt-BR/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "1230",
    "currency": "EUR",
    "paymentForms": [
      {
     "paymentMethodType": "CARD",
     "pan": "4970110000001029",
     "expiryMonth": "03",
     "expiryYear": "27",
     "securityCode": "123"
      }
    ],
    "customer": {
     "email": "sample@example.com"
    },
    "authenticationDetails":{
     "protocol":{
      "name":"THREEDS",
      "version":"2",
      "directoryServer":"CB",
      "challengePreference":"NO_CHALLENGE_REQUESTED"
     },
     "status":"SUCCESS",
     "authenticationType":"FRICTIONLESS",
     "commerceIndicator":"05",
     "authenticationValue":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=",
     "dsTransID":"d6706a0d-c48d-4cf4-a1d2-d4a401a3143e",
     "acsTransID":"d727ebfe-de4c-4682-85fa-e60ca00a9cff",
     "authValueAlgorithm":"2",
     "dsScore":"31",
     "exemption":"LOW_VALUE",  
     "requestorName":"DEMO STORE"
    }
   }

Para obter informações completas e descrições de campos, consulte o playground: V4.1/PCI/Charge/CreatePayment (menu à esquerda)

Para o rede VISA / Mastercard / AMEX

Solicitação

Champs obligatoires
  • VALOR
  • Moeda

Dados do cartão

  • Tipo de meio de pagamento:CARDS
  • Número principal do cartão: pan.
  • Mês de vencimento.
  • Ano de vencimento.

Dados de autenticação

  1. No protocolo
  • sobrenome:THREEDS
  • número de versão
  • directoryServer: nome do DS Ex:VISAouMASTERCARDouAMEX
  • challengePreference: Ex:NO_CHALLENGE_REQUESTEDNo caso de sucesso da autenticação (statusSUCCESSouATTEMPT).
  1. Dados de teste
authenticationType : FRICTIONLESS dsTransID : d6706a0d-c48d-4cf4-a1d2-d4a401a3143e
authenticationValue : +kAr/o8S0DxgGYkz7QQHZCw8V5k= commerceIndicator : 05
challengePreference : NO_CHALLENGE_REQUESTED exemption : LOW_VALUE

Exemplo de solicitação para VISA

/pt-BR/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "990",
    "currency": "EUR",
    "paymentForms": [
      {
     "paymentMethodType": "CARD",
     "pan": "4970110000001029",    
     "expiryMonth": "09",
     "expiryYear": "27",
     "securityCode": "123"
      }
    ],    
    "customer": {
     "email": "sample@example.com"
    },    
    "authenticationDetails":{ 
     "protocol":{
      "name":"THREEDS",
      "version":"2.1.0",
      "directoryServer":"VISA",
      "challengePreference":"NO_CHALLENGE_REQUESTED"
     },   
     "status":"SUCCESS",
     "authenticationType":"FRICTIONLESS",
     "commerceIndicator":"05",
     "authenticationValue":"+kAr/o8S0DxgGYkz7QQHZCw8V5k=",
     "dsTransID":"d6706a0d-c48d-4cf4-a1d2-d4a401a3143e",  
     "exemption":"OTHER_EXEMPTION",
    }    
   }

Para obter informações completas e descrições de campos, consulte o playground: V4.1/PCI/Charge/CreatePayment (menu à esquerda)

Autenticação desligada

O serviço permite que você crie um pagamento quando a autenticação do titular do cartão foi desativada voluntariamente.

Neste caso, o motivo desta decisão deve ser especificado através do campoisenção (Ver capítulo Motivo da paralisação e isenções ).

Champs obligatoires
  • VALOR
  • Moeda

Dados do cartão

  • Tipo de meio de pagamento:CARDS
  • Número principal do cartão: pan.
  • Mês de vencimento.
  • Ano de vencimento.

Dados de autenticação

  • Status:DISABLED
  • Isençaõ: Ver : Modo seletivo e isenções.

Exemplo de solicitação

/pt-BR/rest/V4.0/api/kb/authentication.html
https://api.lyra.com/api-payment/V4.1/Charge/CreatePayment
  {
    "amount": "1230",
    "currency": "EUR",
    "paymentForms": [
      {
      "paymentMethodType": "CARD",
      "pan": "4970100000000022",			 
      "expiryMonth": "09",
      "expiryYear": "27",
      "securityCode": "123"
      }
    ],		  
    "customer": {
      "email": "sample@example.com"
    },		  
    "authenticationDetails":{				
      "status":"DISABLED",
      "exemption":"OTHER_EXEMPTION"		
    }		  
  }

Para obter informações completas e descrições de campos, consulte o playground: V4.1/PCI/Charge/CreatePayment (menu à esquerda)

Jobs
Legal
GDPR
25.22-1.11