Stepup Request, Choice

post https://3a878b71-bbcd-4968-9cdb-797642e3d652.mock.pstmn.io/stepup-choice

Uma solicitação Stepup é comunicada pela plataforma VCAS ao parceiro. O parceiro responde com parâmetros necessários para VCAS para realizar o desafio step-up.

Body Params

Stepup Request Object

ProcessorId

string

required

Defaults to 5723ae630063ac1a9c3ab079

Identificação do cliente provida pelo VCAS. 24 caracteres.

IssuerId

string

required

Defaults to 5723ae630063ac1a9c3ab083

Identificação do cliente provida pelo VCAS. 24 caracteres.

TransactionId

string

required

Defaults to 00ec043e-40b5-4ce4-95c2-9e83b644f412

ID de referência de transação gerada pelo VCAS; Valor GUID de 36 caracteres.

DSTransactionId

string

Defaults to 00ec043e-40b5-4ce4-95c2-9e83b644f987

ID de referência de transação gerada pelo Directory Server (DS). Formato GUID.

3RIIndicator

string

Indica o tipo de solicitação 3RI para transações EMV. Nota: Deve-se permitir valores futuros neste campo. A EMV reservou até 99 valores para uso futuro.

ThreeDSRequestorAuthenticationInd

string

Indica o tipo de solicitação de autenticação. Esse elemento de dados fornece informações adicionais ao ACS para determinar a melhor abordagem para lidar com uma solicitação de autenticação.

StepupRequestId

string

required

Defaults to 878f4751-4140-4881-9e4a-003e83524f22

Identificador exclusivo para identificar a solicitação Stepup específica. Até 36 caracteres.

StepupCounter

integer

required

Contador para o número de chamadas Stepup. Cada ciclo Stepup pode seguir o fluxo Stepup ➤ InitiateAction ➤ Validate. Se o usuário solicitar um "reenvio" por meio do navegador ou de modelos de aplicativos nativos, ele iniciará outra solicitação de Stepup. Nota: O valor inicial será 0 (zero).

DeviceLocale

string

Defaults to en-US

Localidade do dispositivo no cabeçalho do navegador ou nas configurações de idioma do aplicativo nativo. Esse valor pode ser um único valor de localidade ou vários valores concatenados por vírgulas. No EMV 3DS isso não está disponível devido a novos fluxos, portanto este será um valor de idioma único seguindo o formato BCP 47; e.g. en-US ou en,es-PE;q=0.9,es;q=0.8

DeviceUserAgent

string

Defaults to Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML, like Gecko) Chrome/87.0.4280.88 Safari/537.36

Agente de usuário do dispositivo no cabeçalho do navegador ou no identificador de dispositivo do aplicativo. Até 2048 caracteres.

MessageVersion

string

required

Defaults to 2.2.0

Versão do protocolo 3DS baseado nas especificações 3DS. Esta versão será incrementada a cada nova especificação lançada pela EMVCo para 2.x. Isso normalmente seguirá um formato de versão X.Y.Z. Exemplos 2.1.0, 2.2.0

RDXMessageVersion

string

Defaults to 2.2.3

Versão do protocolo RDX em uso. Usado para habilitar novos recursos sem quebra de integrações atuais. Exemplo: 2.2.2 and 2.2.3

MessageCategory

string

Defaults to 01

Identifica a categoria da mensagem para um caso de uso específico; 01=PA, 02=NPA

StepupReason

string

O motivo pelo qual a solicitação Stepup foi iniciada. Exemplo: CARDHOLDER_RESEND - Quando o titular do cartão é desafiado e clica no botão Reenviar na página de validação de OTP, a próxima solicitação Stepup conterá este valor. Nota: Disponível apenas para Reenvio do Titular do Cartão, podendo ser acrescidos valores e cenários futuros.

MerchantInfo

object

PaymentInfo

object

TransactionInfo

object

CardholderSelectionInfo

object

Object defining the consumers selection during the Cardholder Selection OTP flow. This feature is only populated and enabled for issuers supporting this flow.

EmbeddedOOBResponseUrlInfo

string

O emissor deve redirecionar para esse URL quando a validação for concluída, durante um desafio OOB (Out-of-Band) habilitado.

Responses

Response body

object

ProcessorId

string

required

Defaults to 5723ae630063ac1a9c3ab079

Repetido da chamada de Request. Max. 24 caracteres.

IssuerId

string

required

Defaults to 5723ae630063ac1a9c3ab088

Repetido da chamada de Request. Max. 24 caracteres.

TransactionId

string

required

Defaults to 00ec043e-40b5-4ce4-95c2-9e83b644f412

Repetido da chamada de Request. Max. 36 caracteres.

StepupRequestId

string

required

Defaults to 00ec043e-40b5-4ce4-95c2-9e83b644f321

Repetido da chamada de Request. Length - 36 caracteres.

StepupType

string

Usado para identificar o tipo de Stepup. Se StepupType estiver incluído na resposta, o StepupResponse.Credential também deve ser retornado.

CHOICE OTP KBA BIOMETRIC OUTOFBAND OTP_AND_KBA OTP_CHOICE_AND_KBA OUTOFBAND_EMBEDDED

Language

string

Idioma para exibir as instruções e solicitar ao titular do cartão. Este valor decidirá qual modelo será carregado, desde que o modelo de idioma esteja disponível. Se não for fornecido, o idioma será selecionado com base na configuração do emissor e na preferência do navegador. Max. 8 caracteres.

Status

string

required

ERROR é devolvido em qualquer problema interno/técnico. AUTHENTICATED retornará um Y de volta ao comerciante.

SUCCESS AUTHENTICATED FAILURE FAILWITHFEEDBACK ERROR BLOCKED REJECTED INFORMATION ONLY

TransStatusReason

string

Fornece informações sobre o campo Transaction Status possui o valor especificado. 2 caracteres.

RiskIndicator

string

Se retornado, esse valor será usado na criação de determinados Valores de Autenticação (AV) para EMV 3DS.
O valor enviado deve estar em conformidade com o valor AV atual que o emissor está usando. Isso também pode depender da bandeira do cartão da transação. Por exemplo, CAVV e IAV aceitam valores diferentes.
Nas respostas do Desafio (Stepup, InitiateAction, Validate) este valor é atualmente ignorado para usos de CAVV em favor do mapeamento para o “Credential Type”. Para o uso do Enhanced IAV SPA2, se enviado, esse valor substituirá o mapeamento para o “Tipo de credencial”.
Nota: Este valor será convertido em um equivalente hexadecimal.
maximum: 3

Credentials

array of objects

required

Credentials*

object

string

Identificador da credencial solicitada, que será repassada na solicitação InitiateAction e também no ValidateRequest. O comprimento deve ser de 36 caracteres. Nota: O ID deve ser exclusivo por objeto de credencial retornado. O Id é usado para distinguir o tipo de credencial específico e a credencial do titular do cartão nas chamadas InitiateAction e ValidateRequest anteriores. 36 caracteres.

Type

string

Tipo de credencial usada para Stepup.

OTPEMAIL OTPSMS OTPIVR KBASINGLE BIOMETRIC OUTOFBANDOTHER

Text

string

Dados dinâmicos a serem exibidos ao titular do cartão, por examplo, número de telefone ou endereço de e-mail mascarado. Certos modelos de navegador exibirão apenas um número limitado de caracteres antes de mostrar reticências (...). Até 35 caracteres. Nos fluxos EMV SDK, o espaço de texto é limitado a 40 caracteres.

Reason

object

ReasonCode

string

Usado pelo emissor para fim informativo. Até 32 caracteres.

ReasonDescription

string

Usado pelo emissor para fim informativo. Até 256 caracteres.

Error

object

ReferenceNumber

string

Número de referência do sistema para a mensagem de erro. Até 15 caracteres.

ReasonDescription

string

Utilizado pelo emissor para fim informativo. Até 256 caracteres.

Description

string

Descrição do erro. Até 50 caracteres.

Message

string

Uma mensagem que pode ser usada para exibir texto ao titular do cartão em determinados modelos. Os status suportados para este campo são BLOCKED, ERROR e FAILWITHFEEDBACK. Nota: o Emissor também deve estar configurado para tela de erro para que o status ERROR funcione corretamente.Para transações EMV 3DS este valor será inserido em um campo de mensagem que será enviado de volta ao Lojista. Este campo deve ter no máximo 128 caracteres e não é combinado com nenhum outro dado. Se este campo for omitido, qualquer conteúdo estático armazenado para o Emissor e o modelo será retornado. Até 128 caracteres.

WhyInfo

object

Label

string

Informação a ser exibida ao titular do cartão na seção de informações "por que". Até 45 caracteres.

Text

string

Texto fornecido pelo emissor para ser exibido ao titular do cartão para explicar por que o titular do cartão está sendo solicitado a realizar a tarefa de autenticação. Nota: O retorno da operadora carro é suportado neste elemento de dados e é representado por um “\n”. A exibição deste campo nas telas do consumidor está limitada a 256 caracteres.

405

Entrada inválida

200Successful Stepup Response