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.
| Nome | Descrição | Tipo | Tamanho | Condição |
|---|---|---|---|---|
| ProcessorId | Identificação fornecida pelo VCAS. | String | 24 caracteres | Requerido |
| IssuerId | Identificação fornecida pelo VCAS. | String | 24 caracteres | Requerido |
| TransactionId | ID de referência de transação gerada por VCAS: valor GUID de 36 caracteres. | String | Até 36 caracteres | Requerido |
| DSTransactionId | ID de referência de transação gerada pelo Directory Server (DS). Formato GUID. | String | 36 caracteres | Condicional |
| 3RIIndicator | Indica 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. | String; enum | varies | Opcional |
| 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. | String | Até 2 caracteres | Opcional |
| StepupRequestId | ID exclusivo para identificar a solicitação Stepup específica. O comprimento é de 36 caracteres. | String | Até 36 caracteres | Opcional |
| StepupCounter | Contador para o número de chamadas Stepup. 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). | Integer | Requerido | |
| StepupType | O 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 | String | Enum | Opcional; usado apenas durante o Stepup desafio |
| OtpReferenceCode | Este é 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: Emissores que utilizarem este campo devem consultar seu representante VCAS para garantir que ele seja exibido nas telas voltadas ao consumidor. | String | Até 8 caracteres | Opcional |
| OOBPushCallbackUrl | URL fornecida pelo VCAS para ser utilizada pelo emissor a fim de retornar a resposta OOBCallbackValidateStatus ao serviço RDX/VCAS durante o fluxo de OOB Callback. O emissor deve anexar o status da transação à URL. Exemplos: UAT/STAGE: https://uat.oobpush.api.vcas.visa.com/V1/OOBPushValidateStatus PROD: https://oobpush.api.vcas.visa.com/V1/OOBPushValidateStatus | String | Até 62 caracteres | Condicional; Usado apenas com OOB Callback API |
| VerificationToken | Token (OTP) a ser enviado ao titular do cartão. | String | Até 18 caracteres | Opcional |
| 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 | String | Até 8 caracteres | Requerido |
| RDXMessageVersion | Versão do protocolo RDX em uso. Isso será usado para habilitar novos recursos sem interromper as integrações atuais. Exemplo: 2.2.2 | String | Até 8 caracteres | Opcional |
| MessageCategory | Identifica a categoria da mensagem para um caso de uso específico; 01=PA, 02=NPA | String | 2 caracteres | Opcional |
| Credentials | Uma lista de objetos Credenciais que serão usados para desafiar o usuário. Deve conter pelo menos uma informação de contato do consumidor. | List.Object | Mínimo um caractere | Requerido |
| MerchantInfo | Objeto contendo as informações do comerciante. | Object | NA | Opcional |
| PaymentInfo | Objeto contendo as Informações de Pagamento. | Object | NA | Opcional |
| TransactionInfo | Objeto contendo as informações da Transação. | Object | NA | Opcional |
Updated about 1 month ago