> For the complete documentation index, see [llms.txt](https://docs.payvalida.com/api-tarjeta/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.payvalida.com/api-tarjeta/master/sdk-para-3ds-y-score-de-riesgo-transaccional/guia-de-integracion-con-el-sdk-para-web/api.md).

# API

## 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

{% tabs %}
{% tab title="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)                              |
| {% endtab %}    |                                                                                  |

{% tab title="Respuesta" %}

| Respuesta       | Descripción                                                                                                                                                                                                                        |
| --------------- | ---------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- |
| isApproved      | Estado de antifraude                                                                                                                                                                                                               |
| threeDSRequired | Especifica si la transacción requiere 3DS                                                                                                                                                                                          |
| Data            | <p></p><ul><li>KountSessionID si es necesario - debe incluirse en la transacción</li><li>Franchise (en caso de requerir 3DS)</li><li>pvThreedsId (en caso de requerir 3DS)</li><li>referenceId (en caso de requerir 3DS)</li></ul> |
| error           | Mensaje de error en caso de fallo                                                                                                                                                                                                  |
| errorCode       | Código de error (Útil en caso de soporte)                                                                                                                                                                                          |
| {% endtab %}    |                                                                                                                                                                                                                                    |
| {% endtabs %}   |                                                                                                                                                                                                                                    |

## 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

{% tabs %}
{% tab title="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.     |
| {% endtab %} |                                                                       |

{% tab title="Respuesta" %}

| Respuesta     | Descripción                               |
| ------------- | ----------------------------------------- |
| isApproved    | Estado de antifraude                      |
| error         | Mensaje de error en caso de fallo         |
| errorCode     | Código de error (Útil en caso de soporte) |
| {% endtab %}  |                                           |
| {% endtabs %} |                                           |

<br>