API

Define los endpoints disponibles y cómo consumirlos (request/response, ejemplos, errores).

1. Inicialización (PayvalidaSDK)

Configuración del SDK para el correcto funcionamiento

Requisitos previos:

• Ambiente a usar.

• Conocer si el cliente de integración es una Single Page Application (SPA)

• Datos para configuración para uso de 3ds.

Parámetros (Objeto)

Parámetros	Descripción
environment	Ambiente a usar 'sandbox' o 'production'
isSinglePageApp	Se debe especificar si el cliente es tipo SPA o no (false por defecto)
threedsConfig	Requerido en caso de activación de 3DS

2. Validación de Score de riesgo (startAntiFraudValidator)

Realiza evaluación de riesgo para procesamiento de transacciones

Requisitos previos:

• Datos básicos de la tarjeta

• Token de la orden

Parámetros (Objeto)

Parámetros	Descripción
token	Token de la orden
cardNumber	Número de tarjeta
expirationMonth	Mes de expiración de la tarjeta en formato MM (por ejemplo: 06 para junio)
expirationYear	Año de expiración de la tarjeta en formato AA (por ejemplo: 32 para el año 2032)
transactionType	Tipo de transacción 'CIT' o 'MIT' (CIT por defecto)

Respuesta

3. Validación 3D Secure (startThreedsValidator)

Valida transacciones con tarjeta utilizando el protocolo de autenticación 3D Secure

Requisitos previos:

• Haber ejecutado el metódo startAntiFraudValidator para obtener los datos:

  • Franchise

  • pvThreedsId

  • referenceId

• Datos de tarjeta

• Datos del tarjetahabiente

• Token de la orden

Parámetros (Posicionales)

Parámetros	Descripción
data	https://gist.github.com/gamelio-pv/ce21165ddfdb80d6279e091abfba5ff9
containerId	(Opcional) ID del elemento HTML donde se desea mostrar el iframe.

Respuesta