RDX Specification

InitiateActionRequest

A chamada de Initiate Action é usada para sinalizar ao cliente para executar uma ação em um ponto do fluxo

Referência para a chamada de API InitiateAction: Especificação interativa para chamada/resposta.

Exemplo de codificação para a InitiateAction: Exemplo de codificação com trechos de pseudocódigos.

NomeDescriçãoTipoTamanhoCondição
ProcessorId Identificação fornecida pelo VCAS.StringAté 24 caracteresRequerido
IssuerId Identificação fornecida pelo VCAS.StringAté 24 caracteresRequerido
TransactionId ID de referência de transação gerada por VCAS: valor GUID de 36 caracteres.StringAté 36 caracteresRequerido
DSTransactionId ID de referência de transação gerada pelo Directory Server (DS). Formato GUID.String36 caracteresCondicional
3RIIndicatorIndica o tipo de solicitação 3RI para transações EMV.

Observação: Deve-se permitir valores futuros neste campo. A EMV reservou até 99 valores para uso futuro.

3RI Indicator Values
String; enumvariesOpcional
ThreeDSRequestorAuthenticationInd Indica o tipo de solicitação de Autenticação. Este elemento de dados fornece informações adicionais ao ACS para determinar a melhor abordagem para lidar com uma solicitação de autenticação.

3DS Requestor Authentication Indicator Values
StringAté 2 caracteresOpcional
StepupRequestIdID exclusivo para identificar a solicitação Stepup específica. O comprimento é de 36 caracteres.StringAté 36 caracteresOpcional
StepupCounter 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).
IntegerRequerido
StepupTypeO valor do campo StepupType que foi retornado na resposta Stepup, o RDX retornará esse mesmo valor no campo na solicitação InitiateAction
Stepup Type Values
StringEnumOpcional; usado apenas durante o Stepup desafio
OtpReferenceCodeEste é um valor único gerado a cada novo valor OTP ou “VerificationToken”. No caso em que o consumidor pode receber vários OTPs para a mesma transação, isso pode ser aproveitado para mostrar ao consumidor qual OTP o sistema espera que seja inserido. Este valor deverá ser enviado no SMS ou Email junto com o VerificationToken e depois exibido na tela do consumidor.

Nota: Se o emissor pretender usar este campo, deverá consultar seu representante VCAS para garantir que este campo seja exibido nas telas voltadas para o consumidor.
StringAté 8 caracteresOpcional
VerificationTokenToken (OTP) a ser enviado ao titular do cartão.StringAté 18 caracteresOpcional
MessageVersion 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. Exemplo: 2.2.0
StringAté 8 caracteresRequerido
RDXMessageVersion Versão do protocolo RDX em uso. Isso será usado para habilitar novos recursos sem interromper as integrações atuais. Exemplo: 2.2.2StringAté 8 caracteresOpcional
MessageCategoryIdentifica a categoria da mensagem para um caso de uso específico; 01=PA, 02=NPAString2 caracteresOpcional
CredentialsUma lista de objetos Credenciais que serão usados ​​para desafiar o usuário. Deve conter pelo menos uma informação de contato do consumidor.

InitiateActionRequest.Credentials.Credential
List.ObjectMínimo um caractereRequerido
MerchantInfo Objeto contendo as informações do comerciante.

InitiateActionRequest.MerchantInfo
ObjectNAOpcional
PaymentInfo Objeto contendo as Informações de Pagamento.

InitiateActionRequest.PaymentInfo
ObjectNAOpcional
TransactionInfo Objeto contendo as informações da Transação.

InitiateActionRequest.TransactionInfo
ObjectNAOpcional