RDX Specification

ValidateRequest

La solicitud de Validación es comunicada por la plataforma VCAS al cliente. El cliente responde con lógica de éxito, fracaso o reintento.

Referencia de la API ValidateRequest: Especificación interactiva de solicitud/respuesta.

Guia de Código para ValidateRequest: Recurso de pseudocódigo con fragmentos de código.

NameDescriptionTypeLengthRequired
ProcessorId Identificador proporcionado por VCAS para el cliente.StringUp to 24 charactersRequired
IssuerId Identificador proporcionado por VCAS para el cliente.StringUp to 24 charactersRequired
TransactionId ID de referencia de transacción generado por VCAS: 36-character GUID valueStringUp to 36 charactersRequired
StepupType El valor StepupType que se devolvió en la respuesta RDX Stepup, RDX devolverá este campo en la solicitud de validación.

Stepup Type Values
StringEnumOptional; usado solo durante el Stepup desafío
DSTransactionId ID de referencia de transacción generado por el servidor de directorio (DS). Formato GUID. Nota: Solo transacciones EMV 3DS.String36 charactersConditional
StepupRequestId Identificador único para identificar la solicitud de Stepup en particular. Length is 36 characters.StringUp to 36 charactersOptional
FirstFactorOutcomeProporcionará el resultado de la primera autenticación. Valores de la respuesta de validación:

SUCCESS: Continúa la transacción con un estado de autenticación exitoso del primer factor.
FAILURE: Continúa la transacción con un estado de autenticación fallido del primer factor.
RETRY: Permite al titular de la tarjeta volver a intentar la autenticación y se puede construir una lógica de validación para limitar el número de intentos de autenticación. Nota: Este estado solo es aplicable cuando VCAS no está validando el OTP del emisor o el valor del Token.
El siguiente estado no debería aplicarse para el resultado del primer factor a menos que el cliente esté realizando la validación en el primer factor y los devuelva en la primera respuesta de validación de RDX del factor.
PENDING: Iniciará otra solicitud de validación de VCAS al emisor después de 2 segundos y solo se utilizará cuando StepUpResponse ➤ Type es OUTOFBANDOTHER o BIOMETRIC
FAILWITHFEEDBACK: Presenta una pantalla al titular de la tarjeta con instrucciones para obtener ayuda y enviará de vuelta un estado de autenticación fallido al comercio.
BLOCKED: Bloquea la tarjeta y devuelve un estado de autenticación fallido al comercio, los futuros intentos de autenticación fallan hasta que se desbloquea.
REJECTED: Solo compatible con transacciones 2.x.x. Este estado finaliza la transacción con un estado de autenticación rechazado al comercio e indica que no deben proceder con la autorización.

Nota: Error y Stepup no están disponibles como valores de estado porque RDX no continuará con la porción del segundo factor. Error devolverá un estado de autenticación no disponible y Stepup enviará una nueva solicitud de RDX Stepup.
StringEnumOptional
StepupCounter Contador para rastrear el número de llamadas de Stepup. Cada Stepup puede ir de Stepup ➤ InitiateAction ➤ Validate.

Si el usuario solicita un "reenvío" a través de los templates del navegador o de la aplicación nativa, se iniciará otra solicitud de Stepup.

Nota: El valor inicial será 0 (cero).
IntegerRequired
MessageVersion Versión del protocolo 3DS basado en la especificación 3DS.

Esta versión se incrementará con cada nueva especificación lanzada por EMVCo para 2.2. Normalmente seguirá un formato de versión X.Y.Z. Ejemplo: 2.2.0
StringUp to 8 characters.Required
RDXMessageVersion Versión del mensaje del protocolo RDX que se está utilizando. Esto se utilizará para habilitar nuevas características sin romper las integraciones actuales. Ejemplo: 2.2.2StringUp to 8 charactersOptional
BehavioralBiometricsResultObjeto para validar el resultado en la autenticación biométrica de comportamiento.

ValidateRequest.BehavioralBiometricsResult
List.ObjecctNARequired
CredentialResponseUna lista de objetos de respuesta de credenciales. Debe contener al menos un objeto de credenciales. Este objeto se utiliza para validar el desafío y puede contener valores ingresados por el consumidor; por ejemplo, el registro contendrá el valor OTP para validar.

ValidateRequest.CredentialResponse
List.ObjectNARequired