Instalación del SDK
SDK 2.1.1El script#
<script src="https://app.tilopay.com/sdk/v2/sdk_tpay.min.js"></script>Cargalo antes de tu propio código de checkout. El SDK expone el objeto global Tilopay. La
versión vigente es la 2.1.1.
jQuery no es requerido#
jQuery NO es requerido. Desde la versión 2.0.0 el SDK está escrito en JavaScript: podés instalarlo sin jQuery en la página.
Historial de versiones#
| Versión | Fecha | Cambio |
|---|---|---|
| 1.0.0 | 29/07/2022 | Formulario de pago Tilopay |
| 1.1.0 | 05/10/2022 | Tarjetas guardadas y SINPE Móvil |
| 2.0.0 | 01/06/2023 | Migración de jQuery a JavaScript |
| 2.1.0 | 30/08/2023 | InitTokenize() para guardar tarjetas |
| 2.1.1 | — | Apple Pay |
Dominios para Content-Security-Policy#
Si tu sitio usa Content-Security-Policy, permití los orígenes que carga el SDK:
| Origen | Cuándo |
|---|---|
https://app.tilopay.com | Siempre |
https://api.tokenex.com | Siempre |
https://h.online-metrix.net | Siempre |
https://storage.googleapis.com | Siempre |
https://cdn.jsdelivr.net | Siempre |
https://applepay.cdn-apple.com | Solo si usás Apple Pay |
Lo que no hay#
No hay versionado inmutable, no hay hash SRI y no hay changelog. La URL
/sdk/v2/sdk_tpay.min.js no está anclada a una versión concreta: su contenido puede
cambiar sin aviso previo y sin una nota de cambios pública.
Consecuencias prácticas:
- No podés fijar
integrity="sha384-..."en la etiquetascript, porque el archivo cambia. - No podés depender de un número de build para reproducir un bug.
- Conviene tener pruebas de humo de tu checkout que corran periódicamente, no solo al desplegar.
Aplicaciones de una sola página#
Funciona en React y Vue. Llamá Init() después de que los campos estén montados en el DOM: los usa de inmediato y falla si no existen. Si el formulario se vuelve a montar, volvé a llamar Init().
React Native WebView no está probado por Tilopay y puede desactivar Apple Pay; probalo en tu entorno antes de salir a producción.
Qué sigue#
- Campos del formulario — los ids que el SDK busca.
Tilopay.Init()— iniciar la compra.
Última verificación: 2026-10-22