StepupRequest
Se a avaliação de risco resultar em um status de Desafio (StepUp), o emissor determinará como deseja desafiar o titular do cartão. O resultado desta etapa consiste principalmente em uma lista de formas de desafio do titular do cartão, também conhecida como “Credenciais”.
Referência para a API StepupRequest: Especificação interativa para chamada/resposta.
Exemplo de Codificação para a StepupRequest: Exemplo de codificação com trechos de pseudocódigos.
| Nome | Descrição | Tipo | Tamanho | Condição |
|---|---|---|---|---|
| ProcessorId | ID de referência de transação gerada pelo VCAS: valor GUID de 24 caracteres. | String | Até 24 caracteres | Requerido |
| IssuerId | ID de referência de transação gerada pelo VCAS: valor GUID de 24 caracteres. | String | Até 24 caracteres | Requerido |
| TransactionId | ID de referência de transação gerada pelo 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 | Indicates the type of 3RI request for EMV transactions. Note: Please allow for future values in this field. EMV has reserved up to 99 values for future use. 3RI Indicator Values | String | enum | Opcional |
| ThreeDSRequestorAuthenticationInd | Indicates the type of Authentication request. This data element provides additional information to the ACS to determine the best approach for handling an authentication request. 3DS Requestor Authentication Indicator Values | String | 2 caracteres | Opcional |
| StepupRequestId | Identificador exclusivo para identificar a solicitação Stepup específica. O tamanho é de até 36 caracteres. | String | Até 36 caracteres | Opcional |
| 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). | Integer | Requerido | |
| DeviceLocale | 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. Examplos: | String | Até 2.048 caracteres | Opcional |
| DeviceUserAgent | Agente de usuário do dispositivo no cabeçalho do navegador ou no identificador de dispositivo do aplicativo. | String | Até 2.048 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. Exemplos: 2.1.0, 2.2.0 | String | Até 8 caracteres. | Requerido |
| RDXMessageVersion | Mensagem Versão do protocolo RDX em uso. Isso será usado para habilitar novos recursos sem interromper as integrações atuais. Exemplos: 2.2.2 ou 2.2.3 | 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 |
| StepupReason | 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. | String | Enum | Opcional |
| MerchantInfo | Objeto contendo as informações do comerciante. StepupRequest.MerchantInfo | Object | NA | Opcional |
| PaymentInfo | Objeto que contém o PaymentInfo. StepupRequest.PaymentInfo | Object | NA | Opcional |
| TransactionInfo | Objeto contendo as informações da transação. StepupRequest.TransactionInfo | Object | NA | Opcional |
| CardholderSelectionInfo | Objeto que define a seleção de consumidores durante o fluxo OTP de Seleção de Portadores. Este recurso só é preenchido e habilitado para emissores que suportam este fluxo. StepupRequest.CardholderSelectionInfo | Object | NA | Opcional |
| EmbeddedOOBResponseUrl | O emissor deve redirecionar para esse URL quando a validação for concluída, durante um desafio OOB (Out-of-Band) habilitado. | String | NA | Condicional |
Updated 4 months ago