RDX 2.2.3 YAML File
Este documento proporciona un formato de archivo fácil de usar para ver e implementar solicitudes y respuestas de la API de VCAS RDX, incluyendo Riesgo, Stepup, InitateAction y Validate.
openapi: 3.0.1
info:
title: VCAS Real-Time Data Exchange (RDX) API
description: "Este documento proporciona un formato de archivo fácil de usar para\
\ ver e implementar solicitudes y respuestas de la API de VCAS RDX, incluyendo\
\ Riesgo, Stepup, InitateAction y Validate. Para obtener los mejores resultados,\
\ este archivo debe ser visualizado utilizando Swagger o una herramienta similar\
\ para renderizar el archivo yaml. Este documento está diseñado para ser utilizado\
\ en conjunto con la especificación de Intercambio de Datos en Tiempo Real de\
\ VCAS."
contact:
name: CardinalCommerce
url: http://www.cardinalcommerce.com
version: 2.2.3 - Español
paths:
/risk:
post:
tags:
- RDX Requests
summary: Risk Request
description: "El riesgo es el primer paso en el proceso RDX y es la culminació\
n de la transacción, comercio, consumidor e información del dispositivo que\
\ se utiliza para evaluar si la transacción tiene algún riesgo."
operationId: risk
requestBody:
description: Risk Request Object
content:
application/json:
schema:
$ref: '#/components/schemas/RiskRequest'
required: true
responses:
"200":
description: Successful Risk Response
content:
application/json:
schema:
$ref: '#/components/schemas/RiskResponse'
"405":
description: Invalid input
content: {}
x-codegen-request-body-name: body
/stepup:
post:
tags:
- RDX Requests
summary: Stepup Request
description: "Si la evaluación de riesgo resulta en un estado de Stepup, el\
\ emisor entonces determina cómo quiere desafiar al titular de la tarjeta.\
\ El resultado de este paso consiste principalmente en una lista de formas\
\ en que se puede desafiar al titular de la tarjeta, también conocidas como\
\ \"Credenciales\"."
operationId: stepup
requestBody:
description: Stepup Request Object
content:
application/json:
schema:
$ref: '#/components/schemas/StepupRequest'
required: true
responses:
"200":
description: Successful Stepup Response
content:
application/json:
schema:
$ref: '#/components/schemas/StepupResponse'
"405":
description: Invalid input
content: {}
x-codegen-request-body-name: body
/initiateaction:
post:
tags:
- RDX Requests
summary: Initiate Action Request
description: La solicitud de Initiate Action se utiliza para señalar al cliente
que tome acción sobre un ítem.
operationId: initiateaction
requestBody:
description: InitiateAction Request Object
content:
application/json:
schema:
$ref: '#/components/schemas/InitiateActionRequest'
required: true
responses:
"200":
description: Successful Initiate Action Response
content:
application/json:
schema:
$ref: '#/components/schemas/InitiateActionResponse'
"405":
description: Invalid input
content: {}
x-codegen-request-body-name: body
/validate:
post:
tags:
- RDX Requests
summary: Validate Request
description: "The Validate request is communicated by the VCAS platform to the\
\ partner. The partner responds with a success, failure or retry logic."
operationId: validate
requestBody:
description: Stepup Validation Request Object
content:
application/json:
schema:
$ref: '#/components/schemas/ValidateRequest'
required: true
responses:
"200":
description: Successful Validate Response
content:
application/json:
schema:
$ref: '#/components/schemas/ValidateResponse'
"405":
description: Invalid input
content: {}
x-codegen-request-body-name: body
components:
schemas:
MerchantInfo:
required:
- MerchantURL
type: object
properties:
AcquirerId:
type: string
description: Identificación del adquirente para el comercio que realiza
la solicitud de compra. Hasta 11 caracteres.
default: "1337"
AcquirerCountryCode:
type: string
description: "Código de país del adquirente. Formato numérico ISO 3166-1.\
\ Los emisores deben estar al tanto del código de país del adquirente\
\ cuando el país del adquirente difiere del país del comercio y el adquirente\
\ se encuentra en el EEE (esto podría significar que la transacción se\
\ encuentra dentro del Área Económica Europea). Nota: Actualmente solo\
\ disponible en EMV 3DS para Visa y Mastercard y transacciones Visa 3DS\
\ 1.0 cuando los datos están presentes y la bandera PSD2 está habilitada.\
\ Max. 3 caracteres."
default: "840"
MerchantId:
type: string
description: Identificación del comercio para el comercio que realiza la
solicitud de compra. Max. 35 caracteres.
default: "876543210"
MerchantName:
type: string
description: Nombre del comercio para el comercio que realiza la solicitud
de compra. Max. 40 caracteres.
default: Ranier Expeditions
MerchantURL:
type: string
description: URL o nombre de la aplicación para el comercio que realiza
la solicitud de compra. Max. 2048 caracteres.
default: https://www.requestor.com
MerchantCategoryCode:
type: string
description: "Código utilizado para describir el tipo de negocio, producto\
\ o servicio del comercio que es específico de la red de pagos. Por favor,\
\ consulte a cada red de pagos para obtener más detalles."
default: "0123"
MerchantCountryCode:
type: string
description: "Código de país del comercio; para transacciones EMV 3DS este\
\ valor es de 3 caracteres; por ejemplo, 840."
default: "840"
MerchantAppRedirectURLInfo:
required:
- MerchantURL
type: object
properties:
AcquirerId:
type: string
description: Identificación del adquirente para el comercio que realiza
la solicitud de compra. Hasta 11 caracteres.
default: "1337"
AcquirerCountryCode:
type: string
description: "Código de país del adquirente. Formato numérico ISO 3166-1.\
\ Los emisores deben estar al tanto del código de país del adquirente\
\ cuando el país del adquirente difiere del país del comercio y el adquirente\
\ se encuentra en el EEE (esto podría significar que la transacción se\
\ encuentra dentro del Área Económica Europea). Nota: Actualmente solo\
\ disponible en EMV 3DS para Visa y Mastercard y transacciones Visa 3DS\
\ 1.0 cuando los datos están presentes y la bandera PSD2 está habilitada.\
\ Max. 3 caracteres."
default: "840"
MerchantId:
type: string
description: Identificación del comercio para el comercio que realiza la
solicitud de compra. Max. 35 caracteres.
default: "987654321"
MerchantName:
type: string
description: Nombre del comercio para el comercio que realiza la solicitud
de compra. Max. 40 caracteres.
default: Ranier Expeditions
MerchantURL:
type: string
description: URL o nombre de la aplicación para el comercio que realiza
la solicitud de compra. Max. 2048 caracteres.
default: https://www.requestor.com
MerchantCategoryCode:
type: string
description: "Código utilizado para describir el tipo de negocio, producto\
\ o servicio del comercio que es específico de la red de pagos. Por favor,\
\ consulte a cada red de pagos para obtener más detalles."
default: "0123"
MerchantCountryCode:
type: string
description: "Código de país del comercio; para transacciones EMV 3DS este\
\ valor es de 3 caracteres; por ejemplo, 840."
default: "0123"
MerchantAppRedirectURL:
type: string
description: La aplicación del comercio declara su URL dentro del mensaje
CReq para que la aplicación de Autenticación pueda llamar a la aplicación
del comercio después de que ha ocurrido la autenticación OOB. Cada transacción
requiere una ID de Transacción única utilizando la ID de Transacción del
SDK. VCAS validará el valor para asegurar que contiene un esquema que
dirigirá la aplicación de autenticación a la aplicación del comercio asociado.
default: merchantScheme://appName?transID=b2385523-a66c-4907-ac3c-91848e8c0067
PaymentInfo:
required:
- CardExpiryMonth
- CardExpiryYear
- CardNumber
type: object
properties:
CardNumber:
type: string
description: Número de la tarjeta de pago utilizada en la transacción. Longitud
- between 13 and 19 caracteres.
default: "4012009500714811"
CardExpiryMonth:
type: string
description: Mes de expiración.
default: "08"
CardExpiryYear:
type: string
description: Año de expiración. 2-digits e.g. 28.
default: "28"
CardType:
type: string
description: "Tipo de tarjeta o cuenta, por ejemplo, Débito o Crédito."
enum:
- Credit
- Debit
- NotApplicable
CardHolderName:
type: string
description: Nombre del titular de la tarjeta. Max. 45 caracteres.
default: Juanita Doe
Address:
required:
- FirstName
- LastName
type: object
properties:
FirstName:
type: string
description: Nombre para la dirección.
MiddleName:
type: string
description: Segundo nombre para la dirección.
LastName:
type: string
description: Apellido para la dirección.
Address1:
type: string
description: Dirección línea 1.
Address2:
type: string
description: Dirección línea 2.
Address3:
type: string
description: Dirección línea 3.
Locality:
type: string
description: "Ciudad, pueblo, etc."
Region:
type: string
description: "Estado, provincia, territorio, etc."
PostalCode:
type: string
description: Código postal.
CountryCode:
type: string
description: Código de país. El formato seguirá; ISO 3166-1; numérico de
3 dígitos.
CartItem:
type: object
properties:
Name:
type: string
description: Nombre del artículo en el carrito de compras. Max. 50 caracteres.
SKU:
type: string
description: SKU del producto. Max. 50 caracteres.
Price:
type: string
description: Precio del artículo. Max. 48 caracteres.
Quantity:
type: string
description: Cantidad de artículos en el carrito. Longitud - 2 caracteres.
ConsumerContact:
type: object
properties:
EmailAddress:
type: string
description: Dirección de correo electrónico para el consumidor. Max. 254
caracteres.
format: email
PhoneNumber:
type: string
description: Número de teléfono para el consumidor. El formato seguirá el
estándar E.164. Max. 15 caracteres.
MobileNumber:
type: string
description: Número de móvil para el consumidor. El formato seguirá el estándar
E.164. Max. 15 caracteres.
WorkNumber:
type: string
description: Número de trabajo para el consumidor. El formato seguirá el
estándar E.164.Max. 15 caracteres.
WalletInfo:
type: object
properties:
Provider:
type: string
description: Nombre del proveedor de la cartera. Max. 100 caracteres.
WalletAge:
maximum: 10000
minimum: 0
type: number
description: Número de días desde que se creó la cartera. Max. 1000 caracteres.
format: Int64
PaymentCardAge:
maximum: 10000
minimum: 0
type: number
description: Número de días que la tarjeta ha estado en la cartera. Max.
1000 caracteres.
format: Int64
MerchantAdditionalData:
type: object
properties:
ShippingIndicator:
type: string
description: Indica el método de envío elegido para la transacción.
enum:
- ShipToBillingAddress
- ShipToVerifiedAddress
- ShipToOtherAddress
- ShipToStore
- DigitalGoods
- TravelOrEventTickets
- Other
DeliveryTimeFrame:
type: string
description: Plazo de entrega.
enum:
- ElectronicDelivery
- SameDayShipping
- OvernightShipping
- TwoOrMoreDaysShipping
DeliveryEmailAddress:
type: string
description: Dirección de correo electrónico donde se entregó la mercancía.
Max. 254 caracteres.
ReorderItemsIndicator:
type: string
description: Indica si el titular de la tarjeta ha pedido anteriormente.
enum:
- FirstTime
- Reordered
PreorderPurchaseIndicator:
type: string
description: Indica la compra con disponibilidad futura.
enum:
- MerchandiseAvailable
- FutureAvailability
PreorderDate:
type: string
description: "Fecha esperada en que la mercancía estará disponible. Formato\
\ – AAAAMMDD: 8 caracteres."
GiftCardAmount:
type: number
description: "Para una tarjeta de regalo, este es el monto de la compra\
\ (representado en cantidad bruta, ejemplo 1000 para $10.00). Max. 15\
\ caracteres."
GiftCardCurrency:
type: string
description: "ISO 4217; estándar numérico de 3 dígitos. [ISO 4217 Link]\
\ https://en.wikipedia.org/wiki/ISO_4217 Longitud - 3 caracteres."
GiftCardCount:
type: number
description: Recuento total de tarjetas prepagadas individuales o tarjetas
de regalo/códigos comprados. Longitud - 2 caracteres.
Device:
type: object
properties:
UserAgent:
type: string
description: Agente de usuario para el navegador o identificador de dispositivo
para la compra en la aplicación. Max. 2048 caracteres.
IP:
type: string
description: Dirección IP del dispositivo. Max. 45 caracteres.
Latitude:
type: string
description: Latitud del dispositivo basada en geolocalización o dirección
IP. Max. 50 caracteres.
Longitude:
type: string
description: Longitud del dispositivo basada en geolocalización o dirección
IP. Max. 50 caracteres.
BrowserAcceptHeader:
type: string
description: Encabezado HTTP Accept crudo del navegador. Max. 2048 caracteres.
BrowserJavaEnabled:
type: string
description: "Indica si el navegador puede ejecutar Java. Ejemplo, true.\
\ Max. 5 caracteres."
BrowserJavascriptEnabled:
type: string
description: "Indica si el navegador puede ejecutar JavaScript. Ejemplo,\
\ true. Max. 5 caracteres."
BrowserLanguage:
type: string
description: Idioma del navegador devuelto de la propiedad del idioma del
navegador. Max. 8 caracteres.
BrowserColorDepth:
type: string
description: Valor que representa la profundidad de bits de la paleta de
colores. Max. 2 caracteres.
BrowserScreenHeight:
type: string
description: Altura de la pantalla del del tarjetahabiente en píxeles. Max.
6 caracteres.
BrowserWidth:
type: string
description: Ancho de la pantalla del del tarjetahabiente en píxeles. Max.
6 caracteres.
BrowserTimeZone:
type: string
description: "Diferencia de tiempo entre la hora UTC y la hora local del\
\ navegador del titular de la tarjeta, en minutos. From Date.getTimezoneOffset()\
\ method. Max. 5 caracteres."
IPCountry:
type: string
description: País de origen de la dirección IP. Disponible solo en transacciones
iniciadas por el navegador cuando la URL del método se completa con éxito.
Longitud varies.
Platform:
type: string
description: "Plataforma del dispositivo. Ejemplo, Android, iOS. Max. 30\
\ caracteres."
DeviceModel:
type: string
description: Fabricante y modelo del dispositivo móvil. Max. 25 caracteres.
OperatingSystemName:
type: string
description: Nombre del sistema operativo del dispositivo. Max. 50 caracteres.
OperatingSystemVersion:
type: string
description: Versión del sistema operativo del dispositivo. Max. 25 caracteres.
Locale:
type: string
description: "Configuración regional del dispositivo desde el encabezado\
\ del navegador o desde la configuración del idioma de la aplicación.\
\ Este valor puede ser un valor de configuración regional único o múltiples\
\ valores concatenados con comas. En EMV 3DS esto no está disponible debido\
\ a nuevos flujos, por lo que será un valor de idioma único siguiendo\
\ el formato BCP 47. Ejemplo: en-US or en, es-PE;q=0.9, es;q=0.8"
AdvertisingId:
type: string
description: ID único disponible para fines de publicidad y detección de
fraude desde la aplicación nativa del comercio. Max. 128 caracteres.
ScreenResolution:
type: string
description: "Ancho y alto de la pantalla en píxeles. Ejemplo, 1080x1920.\
\ Max. 15 caracteres."
DeviceName:
type: string
description: Nombre del dispositivo asignado por el usuario. Max. 50 caracteres.
SDKAppId:
type: string
description: ID Único Universal creado en todas las instalaciones y actualizaciones
de la Aplicación del Solicitante 3DS en un dispositivo del consumidor.
Longitud - Up 36 caracteres.
DeviceExtendedData:
type: string
description: Objeto JSON codificado en Base64url. Información del dispositivo
recopilada por el SDK 3DS de un dispositivo del consumidor. Max. 64000
RiskProvider:
type: object
properties:
Name:
type: string
description: Proveedor de Perfilado de Dispositivos y Motor de Riesgos.
enum:
- TM
- Payfone
- Cardinal
ProviderId:
type: string
description: ID de referencia de transacción del proveedor de riesgos. Max.
100 caracteres.
DeviceId:
type: string
description: "DeviceId puede usarse para identificar comportamientos de\
\ tarjetahabientes riesgosos o buenos. El ID es el ID de sesión de transacció\
n proporcionado por el servidor 3DS. Los datos de DeviceId dependen de\
\ la recopilación de datos de URL del Método, solo para transacciones\
\ basadas en navegador EMV 3DS. Max. 100 caracteres."
DAFExtension :
type: object
properties:
AuthPayCredStatus:
type: string
description: Permite la comunicación del estado de las credenciales de pago autenticadas entre el VDS y el servidor 3DS, y entre el VDS y el ACS. (Y, N, U, B, I); 1 character.
default: 'Y'
AuthPayProcessReqInd:
type: string
description: Indica si el propósito de la transacción es procesar como una transacción DAF o consultar el estado de las credenciales de pago autenticadas. (01, 02); 2 caracteres.
default: '01'
DafAdvice:
type: string
description: Indica al ACS si la transacción debe ser aprobada o si la aprobación es una decisión del emisor. (01 = debe aprobar; 02; decisión del emisor); 2 caracteres.
default: '01'
Version:
type: string
description: Número de versión de la extensión del mensaje que se está utilizando; por ejemplo, 1.0; Hasta 5 caracteres.
default: '1.0'
RiskRequestTransactionInfo:
type: object
properties:
TransactionTimeStamp:
type: string
description: "Marca de tiempo de la transacción en UTC según ISO 8601 UTC\
\ por ejemplo, 2019-03-21T20:55:49.000Z Longitud - 24 caracteres e.g 2023-03-21T20:55:49.000Z"
format: feach-hora
TransactionAmount:
type: number
description: "Monto de la transacción (monto bruto, ejemplo 1000 para $10.00).\
\ Max. 48 caracteres."
format: decimal
TransactionAmountUSD:
type: number
description: "Monto de la transacción en USD (monto bruto, ejemplo 1000 para $10.00).\
\ Max. 48 caracteres."
TransactionCurrency:
type: string
description: "ISO 4217; estándar numérico de 3 dígitos. [ISO 4217 Link]\
\ https://en.wikipedia.org/wiki/ISO_4217 Longitud - 3 caracteres."
default: "840"
TransactionExponent:
type: integer
description: Exponente para formatear el código ISO 4217 de moneda dada.
Longitud - 1 caracter.
TransactionType:
type: string
description: Tipo de transacción.
enum:
- Purchase
- CardAdd
MandatedRegion:
type: string
description: Un valor que describe la región en la que pueden aplicarse
mandatos a la transacción actual. Añadido para soportar las nuevas transacciones
PSD2 en el EEE. Este valor no estará presente a menos que el emisor trabaje
con su gestor de integración para activar las características de PSD2.
Debe tener en cuenta que se añadirán nuevos valores a este campo con el
tiempo debido a la implementación de nuevas regulaciones en otras regiones.
enum:
- EEA
- NONE
- UNKNOWN
PurchaseType:
type: string
description: Tipo de compra que se está autenticando.
enum:
- GoodsOrService
- CheckAcceptance
- AccountFunding
- QuasiCash
- PrepaidActivation
Channel:
type: string
description: Canal en el que se produce la transacción.
default: WEB
enum:
- WEB
- APP
- MWEB
- THREERI
AddressMatch:
type: string
description: "La dirección de envío coincide con la dirección de facturació\
n. Y = la dirección de envío y de facturación son la misma, N = las direcciones\
\ de envío y de facturación son diferentes. El valor es de 1 carácter."
MerchantAdditionalData:
$ref: '#/components/schemas/MerchantAdditionalData'
PaymentInfo:
$ref: '#/components/schemas/PaymentInfo'
BillingAddress:
$ref: '#/components/schemas/Address'
ShippingAddress:
$ref: '#/components/schemas/Address'
ShoppingCart:
type: array
items:
$ref: '#/components/schemas/CartItem'
ConsumerInfo:
$ref: '#/components/schemas/ConsumerContact'
ConsumerWalletInfo:
$ref: '#/components/schemas/WalletInfo'
DeviceInfo:
$ref: '#/components/schemas/Device'
RiskProviderInfo:
$ref: '#/components/schemas/RiskProvider'
TriggeredRuleName:
type: string
description: Nombre de la regla activada durante el procesamiento de riesgo.
RecurringInfo:
type: object
properties:
RecurringFrequency:
type: string
description: Un objeto que contiene la información de pago recurrente, utilizado para procesar transacciones 3RI. Hasta 4 caracteres.
format: string
RecurringExpiry:
type: string
description: Fecha de vencimiento de la tarjeta en archivo para la transacción; AAAAMMDD. 8 caracteres.
format: date
ThreeDSRequestorPriorAuthenticationInfo:
type: object
properties:
threeDSReqPriorAuthData:
type: string
description: Datos que documentan y soportan un proceso de autenticación específico. Hasta 2048 caracteres.
format: string
threeDSReqPriorAuthMethod:
type: string
description: Mecanismo utilizado por el Tarjetahabiente para autenticarse previamente ante el Solicitante 3DS.
format: string
threeDSReqPriorAuthTimestamp:
type: string
description: Fecha y hora en UTC de la autenticación anterior del titular de la tarjeta.
format: AAAAMMDDHHMM
threeDSReqPriorRef:
type: string
description: Proporciona información adicional al ACS para determinar el mejor enfoque para gestionar una solicitud. 36 caracteres.
format: string
TransStatusReason:
type: string
description: Proporciona información sobre por qué el campo Estado de la transacción tiene el valor especificado. Valores de motivo del estado de la transacción; 2 caracteres.
format: string
StepupRequestTransactionInfo:
type: object
properties:
TransactionTimeStamp:
type: string
description: "Marca de tiempo de la transacción en UTC según ISO 8601 UTC\
\ por ejemplo, 2019-03-21T20:55:49.000Z Longitud - 24 caracteres e.g 2023-03-21T20:55:49.000Z"
format: date-time
TransactionAmount:
type: number
description: "Monto de la transacción (monto bruto, ejemplo 1000 para $10.00).\
\ Max. 48 caracteres."
format: decimal
TransactionCurrency:
type: string
description: "ISO 4217; estándar numérico de 3 dígitos. [ISO 4217 Link]\
\ https://en.wikipedia.org/wiki/ISO_4217 Longitud - 3 caracteres."
default: "840"
TransactionExponent:
type: integer
description: Exponente para formatear el código ISO 4217 de moneda dada.
Longitud - One character.
TransactionType:
type: string
description: Tipo de transacción.
enum:
- Purchase
- CardAdd
MandatedRegion:
type: string
description: Un valor que describe la región en la que pueden aplicarse
mandatos a la transacción actual. Añadido para soportar las nuevas transacciones
PSD2 en el EEE. Este valor no estará presente a menos que el emisor trabaje
con su gestor de integración para activar las características de PSD2.
Debe tener en cuenta que se añadirán nuevos valores a este campo con el
tiempo debido a la implementación de nuevas regulaciones en otras regiones.
enum:
- EEA
- NONE
- UNKNOWN
Channel:
type: string
description: Canal en el que se produce la transacción.
default: WEB
enum:
- WEB
- APP
- MWEB
- THREERI
InitiateActionTransactionInfo:
type: object
properties:
TransactionTimeStamp:
type: string
description: "Marca de tiempo de la transacción en UTC según ISO 8601 UTC\
\ por ejemplo, 2019-03-21T20:55:49.000Z Longitud - 24 caracteres e.g 2023-03-21T20:55:49.000Z"
format: date-time
TransactionAmount:
type: number
description: "Monto de la transacción (monto bruto, ejemplo 1000 para $10.00).\
\ Max. 48 caracteres."
format: decimal
TransactionCurrency:
type: string
description: "ISO 4217; estándar numérico de 3 dígitos. [ISO 4217 Link]\
\ https://en.wikipedia.org/wiki/ISO_4217 Longitud - 3 caracteres."
default: "840"
TransactionExponent:
type: integer
description: Exponente para formatear el código ISO 4217 de moneda dada.
Longitud - One character.
TransactionType:
type: string
description: Tipo de transacción.
enum:
- Purchase
- CardAdd
MandatedRegion:
type: string
description: Un valor que describe la región en la que pueden aplicarse
mandatos a la transacción actual. Añadido para soportar las nuevas transacciones
PSD2 en el EEE. Este valor no estará presente a menos que el emisor trabaje
con su gestor de integración para activar las características de PSD2.
Debe tener en cuenta que se añadirán nuevos valores a este campo con el
tiempo debido a la implementación de nuevas regulaciones en otras regiones.
enum:
- EEA
- NONE
- UNKNOWN
Channel:
type: string
description: Canal en el que se produce la transacción.
default: WEB
enum:
- WEB
- APP
- MWEB
- THREERI
Credential:
required:
- Id
- Type
type: object
properties:
Id:
type: string
description: "Identificador para la credencial solicitada, esto se pasará\
\ en la solicitud de InitiateAction así como en la ValidateRequest."
Type:
type: string
description: Tipo de credencial utilizada para Stepup.
enum:
- OTPEMAIL
- OTPSMS
- OTPIVR
- KBASINGLE
- BIOMETRIC
- OUTOFBANDOTHER
- OUTOFBANDTOKEN
Text:
type: string
description: "Datos dinámicos para mostrar al titular de la tarjeta, es\
\ decir, número de teléfono o dirección de correo electrónico enmascarados."
CredentialStepup:
type: object
properties:
CustomerId:
type: string
description: Contiene la ID del cliente del emisor para crear/construir
el perfil de biometría de comportamiento.
Id:
type: string
description: "Identificador para la credencial solicitada, esto se pasará\
\ en la solicitud de InitiateAction así como en la ValidateRequest. La\
\ longitud debe ser de 36 caracteres. Nota: La Id debe ser única por objeto\
\ de credencial devuelto. La Id se utiliza para distinguir el tipo de\
\ credencial específica y la credencial del titular de la tarjeta en las\
\ llamadas precedentes de InitiateAction y ValidateRequest."
Type:
type: string
description: Tipo de credencial utilizada para Stepup.
enum:
- OTPEMAIL
- OTPSMS
- OTPIVR
- KBASINGLE
- BIOMETRIC
- OUTOFBANDOTHER
- OUTOFBANDTOKEN
Text:
type: string
description: "Datos dinámicos para ser mostrados al titular de la tarjeta,\
\ es decir, número de teléfono o dirección de correo electrónico enmascarados.\
\ Ciertas plantillas de navegador sólo mostrarán un número limitado de\
\ caracteres antes de mostrar una elipsis (...). Hasta 35 caracteres.\
\ En los flujos del SDK EMV el espacio de texto está limitado a 40 caracteres.\
\ Se admiten caracteres UTF-8 válidos soportados por los flujos del navegador\
\ y del SDK, como ®, ©, y ™. Actualmente está disponible un mapeado especial\
\ en caso de que el emisor no pueda enviar la Marca Registrada Unicode\
\ ®. En este caso, si el emisor envía exactamente (R) se convertirá al\
\ vuelo al equivalente Unicode. Número de teléfono móvil del titular de\
\ la tarjeta; ej: +12167891234. El formato seguirá el E.164 standard."
Token:
type: string
description: El campo Token estará contenido en la solicitud post al emisor
y se publicará en el iframe incrustado. Esto sólo está disponible para
StepupType OUTOFBAND_EMBEDDED. Requerido cuando Credential.Type es OUTOFBANDTOKEN.
CredentialValidate:
type: object
properties:
Id:
type: string
description: Valor de ID de StepupResponse-> Credential. La longitud es
36 caracteres.
Type:
type: string
description: El valor de Tipo de Credencial que se devolvió en la Respuesta
de RDX Stepup. RDX hará eco de este campo en la solicitud de Validación.
enum:
- OTPEMAIL
- OTPSMS
- OTPIVR
- KBASINGLE
- BIOMETRIC
- OUTOFBANDOTHER
- OUTOFBANDTOKEN
Value:
type: string
description: Valor proporcionado por el titular de la tarjeta. Requerido
con los tipos de respuesta OTP y KBA. No aplicable para otros tipos de
respuesta.
BehavioralBiometricsResult:
type: object
properties:
CustomerId:
type: string
description: Contiene el ID del cliente del emisor para crear/construir
un perfil de Biometría de Comportamiento.
Decision:
type: string
description: "Devuelve el resultado de la decisión de Biometría de Comportamiento\
\ (ALLOW, DENY, ERROR)"
RiskScore:
type: string
description: Puntuación que indica el resultado de la decisión de Biometría
de Comportamiento.
ExemptionInfo:
type: object
properties:
MerchantFraudRate:
type: string
description: "Tasa de fraude del comerciante. Valor de 1 o 2 caracteres.\
\ Nota: Actualmente solo disponible en transacciones Mastercard EMV 3DS\
\ donde los datos de extensión están presentes. Estará disponible en futuras\
\ versiones de EMV. Nota: La tasa de fraude en el EEA se calcula segú\
n PSD2 RTS. Mastercard no calculará ni validará la puntuación de fraude\
\ del comerciante."
example: "1"
SecureCorporatePayment:
type: string
description: "Indica que se utilizaron procesos y procedimientos de pago\
\ dedicados, y que puede aplicarse una exención de pago corporativo segura.\
\ Lógicamente, este campo solo debe establecerse en sí (Y) si el campo\
\ de exención del adquiriente está en blanco. Un comercio no puede reclamar\
\ tanto la exención del adquiriente como el pago seguro. Sin embargo,\
\ el DS no validará las condiciones en la extensión. DS pasará los datos\
\ tal como se presentan. Valores Posibles: \"Y\" or \"N\". Nota: Actualmente\
\ solo disponible en transacciones Mastercard EMV 3DS donde se presentan\
\ datos de extensión."
example: "Y"
MCRiskScore:
type: string
description: "Puntuación de riesgo de Mastercard proporcionada en la extensió\
n del mensaje AReq. Este campo es configurable por los emisores, sin embargo,\
\ los emisores deben solicitar que se habilite esta función. Solo aplicable\
\ para transacciones de Mastercard."
example: "123"
WhitelistStatus:
type: string
description: Indica el estado actual de la lista blanca según lo indicado
por el Servidor 3DS y el DS en la solicitud de autenticación.
enum:
- "Y"
- "N"
- E
- P
- R
- U
WhitelistStatusSource:
type: string
description: Indica de proviene la solicitud de lista blanca. Este será
el valor inicial enviado a VCAS en la solicitud de autenticación.
enum:
- Merchant
- DS
description: Objeto que contiene información relacionada con las exenciones
EMV en relación con las regulaciones PSD2 de EEA.
ExemptionResponse:
type: object
properties:
WhitelistStatus:
type: string
description: Indica si la exención de la lista de permitidos fue aceptada
o no. Debe usarse en conjunto con RiskResponse.Status. El valor puede
dejarse nulo si se acepta o si no es aplicable a la transacción.
enum:
- "Y"
- "N"
- E
- P
- R
- U
description: Objeto que contiene cualquier información relacionada con la evaluación
de ExemptionInfo en el RiskRequest.
MerchantAuthInfo:
type: object
properties:
DecoupledRequestIndicator:
type: string
description: "Indica si el Solicitante 3DS solicita al ACS que utilice la\
\ Autenticación Desacoplada y acepta utilizar la Autenticación Desacoplada\
\ si el ACS confirma su uso. Nota: Actualmente no disponible; puede estar\
\ disponible en una fecha posterior."
enum:
- DecoupledPreferred
- NoDecoupledPreferred
DecoupledMaxTime:
type: string
description: "Indica la cantidad máxima de tiempo que el Solicitante 3DS\
\ esperará a que un ACS proporcione los resultados de la transacción de\
\ Autenticación Desacoplada (en minutos). Se aceptan valores numéricos\
\ entre 1 y 10080. Nota: Actualmente no disponible; puede estar disponible\
\ en una fecha posterior."
description: Objeto que contiene información relacionada con cualquier información
de Autenticación del comercio en solicitudes EMV.
CardholderSelectionInfo:
type: object
properties:
Type:
type: string
description: "Tipo que describe la selección del titular de la tarjeta;\
\ por ejemplo, titular principal o secundario."
enum:
- P
- S
Name:
type: string
description: El nombre del titular de la tarjeta seleccionado. Solo es necesario
si se selecciona un titular secundario para hacer coincidir.
description: Objeto que define la selección de los consumidores durante el flujo
de OTP de Selección del Titular de la Tarjeta. Esta característica solo se
llena y se habilita para los emisores que soportan este flujo.
EmbeddedOOBResponseUrl:
type: string
description: "El emisor debe redirigir a esta URL cuando la validación esté\
\ completa, durante un desafío OOB incorporado."
Reason:
type: object
properties:
ReasonCode:
type: string
description: Utilizado por el emisor para fines informativos. Max. 32 caracteres.
ReasonDescription:
type: string
description: Utilizado por el emisor para fines informativos. Max. 256 caracteres.
WhyInfo:
type: object
properties:
Label:
type: string
description: Etiqueta a ser mostrada al titular de la tarjeta para la sección
de información "por qué".
Text:
type: string
description: "Texto proporcionado por el emisor para ser mostrado al titular\
\ de la tarjeta para explicar por qué se le está pidiendo al titular de\
\ la tarjeta que realice la tarea de autenticación. Notas: El retorno\
\ de carro es soportado en este elemento de datos y está representado\
\ por un “\\n”. La visualización de este campo en las pantallas del consumidor\
\ está limitada a 35 caracteres."
description: "Object defining dynamic text values that can be shown to the consumer\
\ during the challenge flow. These fields will be mapped directly to both\
\ browser templates and SDK info fields. Note: this field is also configurable\
\ for SDK screens today via our template configuration. If this value is passed\
\ on RDX it will override the current configurable value."
ErrorMessage:
type: object
properties:
ReferenceNumber:
type: string
description: Número de referencia del sistema para el mensaje de error.
Max. 15 caracteres.
ReasonDescription:
type: string
description: Utilizado por el emisor para fines informativos. Hasta 256
caracteres.
Description:
type: string
description: Una descripción del error. Max. 50 caracteres.
Message:
type: string
description: "Un mensaje que puede ser utilizado para mostrar texto al titular\
\ de la tarjeta en ciertas plantillas. Los estados soportados para este\
\ campo son BLOCKED, ERROR y FAILWITHFEEDBACK. Nota: que el emisor tambié\
n debe estar configurado para una pantalla de error para que el estado\
\ ERROR funcione correctamente. Para las transacciones EMV 3DS este valor\
\ será insertado en un campo de mensaje que se envía de vuelta al Comerciante.\
\ Este campo debe tener un máximo de 128 caracteres y no se combina con\
\ ningún otro dato. Si este campo se omite, entonces cualquier contenido\
\ estático que se almacene para el emisory la plantilla será devuelto."
RReqOverrides:
type: object
properties:
AuthenticationMethod:
type: string
description: Método de autenticación requerido para los valores RReq y Visa
CAVV.
enum:
- SMS_OTP
- HARDWARE_OTP
- SOFTWARE_OTP
- OTHER_OTP
- KBA
- BIOMETRIC
- APP_LOGIN
- OTHER
TransStatusReason:
type: string
description: Requerido cuando la transacción no está autenticada o cuando
ocurre un error en el caso de uso de OOB incorporado.
enum:
- CARD_AUTH_FAILED
- EXCEEDS_FREQUENCY
- TECHNICAL_ISSUE
AuthenticationAttempts:
type: string
description: Indica el número de ciclos de autenticación intentados por
el titular de la tarjeta. El valor debe ser igual a 2 caracteres (01-99).
CustomerCancel:
type: boolean
description: "Indica si el cliente canceló la transacción. Verdadero si\
\ el cliente hizo clic en \"Cancelar\", de lo contrario falso. Requerido\
\ para el caso de uso de OOB incorporado."
RiskRequest:
required:
- IssuerId
- MerchantInfo
- MessageVersion
- ProcessorId
- TransactionId
- TransactionInfo
type: object
properties:
ProcessorId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab080
TransactionId:
type: string
description: ID de transacción generado por VCAS; formato GUID de 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
DSTransactionId:
type: string
description: ID de transacción generado por el Servidor de Directorio. Formato
GUID.
default: 521fa021-4791-4579-a3e9-76de87c219c0
MerchantChallengeIndicator:
type: string
description: "Indica si se solicita un desafío al comercio. Nota: Por favor\
\ permita valores futuros en este campo. EMV ha reservado hasta 99 valores\
\ para uso futuro."
enum:
- NoPreference
- NoChallenge
- PreferChallenge
- MandatedChallenge
- NoChallengeRiskPerformed
- NoChallengeDataOnly
- NoChallengeSCAPerformed
- NoChallengeWhitelistExempt
- PreferChallengeWhitelistPrompt
3RIIndicator:
type: string
description: "Indica el tipo de indicador iniciado por el solicitante. Nota:\
\ Por favor permita valores futuros en este campo. EMV ha reservado hasta\
\ 99 valores para uso futuro."
enum:
- RecurringTransaction
- InstallmentTransaction
- AddCard
- MaintainCardInformation
- AccountVerification
- SplitOrDelayedShipment
- TopUp
- MailOrder
- TelephoneOrder
- WhitelistStatusCheck
- OtherPayment
NonPaymentAuthenticationIndicator:
type: string
description: Indica el tipo de Autenticación de no Pago.
enum:
- AddCard
- MaintainCard
- CardholderVerification
MessageVersion:
type: string
description: "Versión del mensaje basada en la especificación EMV 3DS. Ejemplo:\
\ 2.2.0"
default: 2.2.0
RDXMessageVersion:
type: string
description: "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.2."
default: 2.2.3
MessageCategory:
type: string
description: Identifica la categoría del mensaje para un caso de uso específico; 01=PA, 02=NPA
default: '01'
RiskScore:
type: string
description: Puntuación de riesgo de la transacción determinada por VCAS.
RuleOutcome:
type: string
description: "Si la transacción está configurada para evaluar las reglas\
\ de riesgo, este será el resultado de esa evaluación."
enum:
- Success
- Fail
- FailWithFeedback
- Challenge
- Rejected
- Error
ExemptionInfo:
$ref: '#/components/schemas/ExemptionInfo'
MerchantAuthInfo:
$ref: '#/components/schemas/MerchantAuthInfo'
MerchantInfo:
$ref: '#/components/schemas/MerchantInfo'
TransactionInfo:
$ref: '#/components/schemas/RiskRequestTransactionInfo'
ExtensionData:
$ref: '#/components/schemas/DAFExtension'
RiskResponse:
required:
- IssuerId
- ProcessorId
- Status
- TransactionId
type: object
properties:
ProcessorId:
type: string
description: Se hizo eco de Risk Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Se hizo eco de Risk Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab081
TransactionId:
type: string
description: Se hizo eco de Risk Request. Max. 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
Status:
type: string
description: Status of Risk Request.
enum:
- SUCCESS
- STEPUP
- FAILURE
- FAILWITHFEEDBACK
- ERROR
- BLOCKED
- REJECTED
TransStatusReason:
$ref: '#/components/schemas/TransStatusReason'
Language:
type: string
description: "Idioma para mostrar las instrucciones y el mensaje al titular\
\ de la tarjeta. Este valor decidirá qué plantilla se carga, siempre que\
\ la plantilla del idioma esté disponible. Si no se proporciona, el idioma\
\ se selecciona en base a la configuración del emisor y la preferencia\
\ del navegador. Idioma para mostrar las instrucciones y el mensaje al\
\ titular de la tarjeta. Este valor decidirá qué plantilla se carga, siempre\
\ que la plantilla del idioma esté disponible. Si no se proporciona, el\
\ idioma se selecciona en base a la configuración del emisor y la preferencia\
\ del navegador."
RiskIndicator:
type: string
description: |
Si se devuelve, este valor se utilizará en la creación de ciertos Valores de Autenticación (AV) para EMV 3DS. El valor pasado debe cumplir con el valor AV actual que el emisor está utilizando. Esto también puede depender de la marca de la tarjeta de la transacción. Por ejemplo, CAVV e IAV aceptan diferentes valores.
En las respuestas de Desafío (Stepup, InitiateAction, Validate) este valor se ignora actualmente para los usos de CAVV en favor de la asignación al "Tipo de Credencial". Para el uso de SPA2 IAV Mejorado, si se pasa, este valor anulará la asignación al "Tipo de Credencial".
Nota: Este valor se convertirá en un equivalente hexadecimal.
RiskScore:
type: string
description: Puntuación de riesgo de la transacción determinada por VCAS.
ExemptionResponse:
$ref: '#/components/schemas/ExemptionResponse'
Reason:
$ref: '#/components/schemas/Reason'
Error:
$ref: '#/components/schemas/ErrorMessage'
StepupRequest:
required:
- IssuerId
- MessageVersion
- ProcessorId
- StepupCounter
- StepupRequestId
- TransactionId
type: object
properties:
ProcessorId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab083
TransactionId:
type: string
description: ID de transacción generado por VCAS; formato GUID de 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
DSTransactionId:
type: string
description: ID de transacción generado por el Servidor de Directorio. Formato
GUID.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f987
3RIIndicator:
type: string
description: 'Indica el tipo de solicitud 3RI para transacciones EMV. Nota: Permita valores futuros en este campo. EMV ha reservado hasta 99 valores para uso futuro.'
enum:
- RecurringTransaction
- InstallmentTransaction
- AddCard
- MaintainCardInformation
- AccountVerification
- SplitOrDelayedShipment
- TopUp
- MailOrder
- TelephoneOrder
- WhitelistStatusCheck
- OtherPayment
ThreeDSRequestorAuthenticationInd:
type: string
description: 'Indica el tipo de solicitud de autenticación. Este elemento de datos proporciona información adicional al ACS para determinar el mejor enfoque para manejar una solicitud de autenticación.'
enum:
- Payment Transaction
- Recurring Transaction
- Instalment Transaction
- AddCard
- MaintainCard
- CardholderVerification
StepupRequestId:
type: string
description: Identificador único para identificar la solicitud de Stepup
en particular; 36 caracteres.
default: 878f4751-4140-4881-9e4a-003e83524f22
StepupCounter:
type: integer
description: "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 las plantillas del navegador o de\
\ la aplicación nativa, iniciará otra solicitud de Stepup. Nota: El valor\
\ inicial será 0 (cero)."
DeviceLocale:
type: string
description: "La configuración regional del dispositivo del encabezado del\
\ navegador o de la configuración de idioma de la aplicación nativa. Este\
\ valor puede ser un único valor de configuración regional o varios valores\
\ concatenados mediante comas. En EMV 3DS esto no está disponible debido\
\ a los nuevos flujos, por lo que será un único valor de idioma siguiendo\
\ el formato BCP 47."
default: en-US
DeviceUserAgent:
type: string
description: Agente de usuario del dispositivo del encabezado del navegador
o el identificador del dispositivo de la aplicación. Max. 2048 caracteres.
default: "Mozilla/5.0 (Windows NT 10.0; Win64; x64) AppleWebKit/537.36 (KHTML,\
\ like Gecko) Chrome/87.0.4280.88 Safari/537.36"
MessageVersion:
type: string
description: "Versión del protocolo 3DS basado en la especificación 3DS.\
\ Esta versión incrementará con cada nueva especificación lanzada por\
\ EMVCo para 2.x. Esto generalmente seguirá un formato de versión X.Y.Z.\
\ Ejemplos: 2.1.0, 2.2.0"
default: 2.2.0
RDXMessageVersion:
type: string
description: "Versión del mensaje del protocolo RDX que se está utilizando.\
\ Esto se utilizará para habilitar nuevas funciones sin interrumpir las\
\ integraciones actuales. Ejemplo: 2.2.2 o 2.2.3"
default: 2.2.3
MessageCategory:
type: string
description: Identifica la categoría del mensaje para un caso de uso específico; 01=PA, 02=NPA
default: '01'
StepupReason:
type: string
description: "La razón por la que se inició la solicitud de Stepup. Ejemplo:\
\ CARDHOLDER_RESEND - Cuando el titular de la tarjeta es desafiado y hace\
\ clic en el botón Reenviar en la página de validación de OTP, la pró\
xima solicitud de Stepup contendrá este valor. Nota: Solo disponible para\
\ Reenvío del titular de la tarjeta, se pueden agregar valores y escenarios\
\ futuros."
enum:
- CARDHOLDER_RESEND
MerchantInfo:
$ref: '#/components/schemas/MerchantAppRedirectURLInfo'
PaymentInfo:
$ref: '#/components/schemas/PaymentInfo'
TransactionInfo:
$ref: '#/components/schemas/StepupRequestTransactionInfo'
CardholderSelectionInfo:
$ref: '#/components/schemas/CardholderSelectionInfo'
EmbeddedOOBResponseUrlInfo:
$ref: '#/components/schemas/EmbeddedOOBResponseUrl'
StepupResponse:
required:
- Credentials
- IssuerId
- ProcessorId
- Status
- StepupRequestId
- TransactionId
type: object
properties:
ProcessorId:
type: string
description: Se hizo eco de Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Se hizo eco de Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab088
isBbConsentRequired:
type: string
description: Indicates if legal consent is required for the behavioral biometrics
flow. Boolean.
TransactionId:
type: string
description: Se hizo eco de Request. Max. 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
StepupRequestId:
type: string
description: Se hizo eco de Request. Longitud - 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f321
StepupType:
type: string
description: Se utiliza para identificar el método Stepup.
enum:
- CHOICE
- OTP
- KBA
- BIOMETRIC
- OUTOFBAND
- OTP_AND_KBA
- OTP_CHOICE_AND_KBA
- OUTOFBAND_EMBEDDED
TransStatusReason:
$ref: '#/components/schemas/TransStatusReason'
Language:
type: string
description: "Idioma para mostrar las instrucciones y el mensaje al titular\
\ de la tarjeta. Este valor decidirá qué plantilla se carga, siempre que\
\ la plantilla del idioma esté disponible. Si no se proporciona, el idioma\
\ se selecciona en base a la configuración del emisor y la preferencia\
\ del navegador. Idioma para mostrar las instrucciones y el mensaje al\
\ titular de la tarjeta. Este valor decidirá qué plantilla se carga, siempre\
\ que la plantilla del idioma esté disponible. Si no se proporciona, el\
\ idioma se selecciona en base a la configuración del emisor y la preferencia\
\ del navegador."
Status:
type: string
description: 'Estado de la Solicitud de Riesgo. '
enum:
- SUCCESS
- AUTHENTICATED
- FAILURE
- FAILWITHFEEDBACK
- ERROR
- BLOCKED
- REJECTED
- INFORMATION ONLY
RiskIndicator:
type: string
description: |
Si se devuelve, este valor se utilizará en la creación de ciertos Valores de Autenticación (AV) para EMV 3DS. El valor pasado debe cumplir con el valor AV actual que el emisor está utilizando. Esto también puede depender de la marca de la tarjeta de la transacción. Por ejemplo, CAVV e IAV aceptan diferentes valores.
En las respuestas de Desafío (Stepup, InitiateAction, Validate) este valor se ignora actualmente para los usos de CAVV en favor de la asignación al "Tipo de Credencial". Para el uso de SPA2 IAV Mejorado, si se pasa, este valor anulará la asignación al "Tipo de Credencial".
Nota: Este valor se convertirá en un equivalente hexadecimal.
oobAppURL:
type: string
description: Universal app link to an authentication app used in OOB authentication. The App URL will open the appropriate location within the authentication app. The issuer is required on Mastercard application-based transactions per Mastercard Bridging Extension Requirements for 2.2 transactions. Max. 2048 caracteres.
Credentials:
type: array
items:
$ref: '#/components/schemas/CredentialStepup'
Reason:
$ref: '#/components/schemas/Reason'
Error:
$ref: '#/components/schemas/ErrorMessage'
WhyInfo:
$ref: '#/components/schemas/WhyInfo'
InitiateActionRequest:
required:
- Credentials
- IssuerId
- MessageVersion
- ProcessorId
- StepupCounter
- StepupRequestId
- TransactionId
type: object
properties:
ProcessorId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab654
TransactionId:
type: string
description: ID de transacción generado por VCAS; formato GUID de 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
DSTransactionId:
type: string
description: ID de transacción generado por el Servidor de Directorio. Formato
GUID.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f258
3RIIndicator:
type: string
description: 'Indica el tipo de solicitud 3RI para transacciones EMV. Nota: Permita valores futuros en este campo. EMV ha reservado hasta 99 valores para uso futuro.'
enum:
- RecurringTransaction
- InstallmentTransaction
- AddCard
- MaintainCardInformation
- AccountVerification
- SplitOrDelayedShipment
- TopUp
- MailOrder
- TelephoneOrder
- WhitelistStatusCheck
- OtherPayment
ThreeDSRequestorAuthenticationInd:
type: string
description: 'Indica el tipo de solicitud de autenticación. Este elemento de datos proporciona información adicional al ACS para determinar el mejor enfoque para manejar una solicitud de autenticación.'
enum:
- Payment Transaction
- Recurring Transaction
- Instalment Transaction
- AddCard
- MaintainCard
- CardholderVerification
StepupRequestId:
type: string
description: Identificador único para identificar la solicitud de Stepup
en particular.
default: 878f4751-4140-4881-9e4a-003e83524f22
StepupType:
type: string
description: Se utiliza para identificar el método Stepup.
enum:
- CHOICE
- OTP
- KBA
- BIOMETRIC
- OUTOFBAND
- OTP_AND_KBA
- OTP_CHOICE_AND_KBA
StepupCounter:
type: integer
description: "Contador para rastrear el número de llamadas Stepup. Cada\
\ Stepup puede ir de Stepup ➤ InitiateAction ➤ Validate. Si el usuario\
\ solicita un \"reenvío\" a través de las plantillas del navegador o de\
\ la aplicación nativa, se iniciará otra solicitud Stepup. Nota: El valor\
\ inicial será 0 (cero)."
OtpReferenceCode:
type: string
description: "Este es un valor único generado con cada nuevo valor OTP o\
\ \"VerificationToken\". En el caso de que el consumidor pueda recibir\
\ múltiples OTPs para la misma transacción, esto se puede aprovechar para\
\ mostrar al consumidor qué OTP espera que se introduzca el sistema. Este\
\ valor debe enviarse en el SMS o correo electrónico junto con el VerificationToken\
\ y luego mostrarse en la pantalla del consumidor. Nota: si el emisor\
\ tiene la intención de usar este campo, debería consultar con su representante\
\ de VCAS para asegurarse de que este campo se muestra en sus pantallas\
\ orientadas al consumidor."
VerificationToken:
type: string
description: Token (OTP) a ser enviado al titular de la tarjeta.
MessageVersion:
type: string
description: "Versión del protocolo 3DS basado en la especificación 3DS.\
\ Esta versión incrementará con cada nueva especificación lanzada por\
\ EMVCo para 2.x. Esto normalmente seguirá un formato de versión X.Y.Z.\
\ Ejemplo: 2.2.0"
default: 2.2.0
RDXMessageVersion:
type: string
description: "Versión del mensaje del protocolo RDX que se está utilizando.\
\ Esto se utilizará para habilitar nuevas características sin interrumpir\
\ las integraciones actuales. Ejemplo: 2.2.3"
default: 2.2.3
MessageCategory:
type: string
description: Identifica la categoría del mensaje para un caso de uso específico; 01=PA, 02=NPA
default: '01'
Credentials:
type: array
items:
$ref: '#/components/schemas/Credential'
MerchantInfo:
$ref: '#/components/schemas/MerchantAppRedirectURLInfo'
PaymentInfo:
$ref: '#/components/schemas/PaymentInfo'
TransactionInfo:
$ref: '#/components/schemas/InitiateActionTransactionInfo'
InitiateActionResponse:
required:
- Credentials
- IssuerId
- ProcessorId
- Status
- StepupRequestId
- TransactionId
type: object
properties:
ProcessorId:
type: string
description: Se hizo eco de Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Se hizo eco de Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab963
TransactionId:
type: string
description: Se hizo eco de Request. Max. 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
StepupRequestId:
type: string
description: Se hizo eco de Request. Longitud - 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f761
TransStatusReason:
$ref: '#/components/schemas/TransStatusReason'
Language:
type: string
description: "Idioma para mostrar las instrucciones y el mensaje al titular\
\ de la tarjeta. Este valor decidirá qué plantilla se carga, siempre que\
\ la plantilla del idioma esté disponible. Si no se proporciona, el idioma\
\ se selecciona según la configuración del emisor y la preferencia del\
\ navegador. Por ejemplo en-US. Max. 8 caracteres."
Status:
type: string
description: Estado de la Solicitud de Riesgo.
enum:
- SUCCESS
- AUTHENTICATED
- STEPUP
- FAILURE
- FAILWITHFEEDBACK
- ERROR
- BLOCKED
- REJECTED
RiskIndicator:
type: string
description: |
Si se devuelve, este valor se utilizará en la creación de ciertos Valores de Autenticación (AV) para EMV 3DS. El valor pasado debe cumplir con el valor AV actual que el emisor está utilizando. Esto también puede depender de la marca de la tarjeta de la transacción. Por ejemplo, CAVV e IAV aceptan diferentes valores.
En las respuestas de Desafío (Stepup, InitiateAction, Validate) este valor se ignora actualmente para los usos de CAVV en favor de la asignación al "Tipo de Credencial". Para el uso de SPA2 IAV Mejorado, si se pasa, este valor anulará la asignación al "Tipo de Credencial".
Nota: Este valor se convertirá en un equivalente hexadecimal.
Credentials:
type: array
items:
$ref: '#/components/schemas/Credential'
Reason:
$ref: '#/components/schemas/Reason'
Error:
$ref: '#/components/schemas/ErrorMessage'
ValidateRequest:
required:
- CredentialResponse
- IssuerId
- MessageVersion
- ProcessorId
- StepupCounter
- StepupRequestId
- TransactionId
type: object
properties:
ProcessorId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Identificador otorgado por VCAS para el cliente. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab481
TransactionId:
type: string
description: ID de transacción generado por VCAS; formato GUID de 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
StepupType:
type: string
description: Se utiliza para identificar el método Stepup.
enum:
- CHOICE
- OTP
- KBA
- BIOMETRIC
- OUTOFBAND
- OTP_AND_KBA
- OTP_CHOICE_AND_KBA
DSTransactionId:
type: string
description: ID de transacción generado por el Servidor de Directorio. Formato
GUID.
default: 521fa021-4791-4579-a3e9-76de87c219c0
FirstFactorOutcome:
type: string
description: 'Proporcionará el resultado de la primera autenticación. Valores
de la respuesta de validación:'
enum:
- SUCCESS
- FAILURE
- RETRY
- PENDING
- FAILWITHFEEDBACK
- BLOCKED
- REJECTED
StepupRequestId:
type: string
description: Identificador único para identificar la solicitud de Stepup
en particular; 36 caracteres.
default: 878f4751-4140-4881-9e4a-003e83524f22
StepupCounter:
type: integer
description: "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)."
MessageVersion:
type: string
description: "Versión del mensaje basada en la especificación EMV 3DS. Ejemplo:\
\ 2.2.0"
default: 2.2.0
RDXMessageVersion:
type: string
description: "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.2."
default: 2.2.3
BehavioralBiometricsResult:
$ref: '#/components/schemas/BehavioralBiometricsResult'
CredentialResponse:
type: array
items:
$ref: '#/components/schemas/CredentialValidate'
ValidateResponse:
required:
- IssuerId
- ProcessorId
- Status
- StepupRequestId
- TransactionId
type: object
properties:
ProcessorId:
type: string
description: Se hizo eco de Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab079
IssuerId:
type: string
description: Se hizo eco de Request. Max. 24 caracteres.
default: 5723ae630063ac1a9c3ab671
TransactionId:
type: string
description: Se hizo eco de Request. Max. 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f412
StepupRequestId:
type: string
description: Identificador único para identificar la solicitud de Stepup
en particular; 36 caracteres.
default: 00ec043e-40b5-4ce4-95c2-9e83b644f618
TransStatusReason:
$ref: '#/components/schemas/TransStatusReason'
Language:
type: string
description: "Idioma para mostrar las instrucciones y el mensaje al titular\
\ de la tarjeta. Este valor decidirá qué plantilla se carga, siempre que\
\ la plantilla del idioma esté disponible. Si no se proporciona, el idioma\
\ se selecciona en base a la configuración del emisor y la preferencia\
\ del navegador. Idioma para mostrar las instrucciones y el mensaje al\
\ titular de la tarjeta. Este valor decidirá qué plantilla se carga, siempre\
\ que la plantilla del idioma esté disponible. Si no se proporciona, el\
\ idioma se selecciona en base a la configuración del emisor y la preferencia\
\ del navegador."
CredentialId:
type: string
description: Valor de ID de StepupResponse -> Credential. Longitud - 36
caracteres.
Status:
type: string
description: Estado de la Solicitud de Riesgo.
enum:
- SUCCESS
- RETRY
- STEPUP
- PENDING
- FAILURE
- FAILWITHFEEDBACK
- ERROR
- BLOCKED
- REJECTED
RiskIndicator:
type: string
description: |
Si se devuelve, este valor se utilizará en la creación de ciertos Valores de Autenticación (AV) para EMV 3DS. El valor pasado debe cumplir con el valor AV actual que el emisor está utilizando. Esto también puede depender de la marca de la tarjeta de la transacción. Por ejemplo, CAVV e IAV aceptan diferentes valores.
En las respuestas de Desafío (Stepup, InitiateAction, Validate) este valor se ignora actualmente para los usos de CAVV en favor de la asignación al "Tipo de Credencial". Para el uso de SPA2 IAV Mejorado, si se pasa, este valor anulará la asignación al "Tipo de Credencial".
Nota: Este valor se convertirá en un equivalente hexadecimal.
Reason:
$ref: '#/components/schemas/Reason'
Error:
$ref: '#/components/schemas/ErrorMessage'
RReqOverrides:
$ref: '#/components/schemas/RReqOverrides'
Updated 9 days ago