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


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET 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?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.