SDK JavaScript
SDK v2Qué es#
Los campos de tarjeta viven en tu página. El SDK V2 toma control de esos inputs y manda los datos del navegador directo a Tilopay: no pasan por tu servidor.
Para quién es#
Para equipos que quieren controlar el diseño del checkout sin que los datos de tarjeta toquen su backend. Necesitás frontend con JavaScript y un backend mínimo para obtener el token del SDK.
Cómo se arma, en orden#
- Credenciales. No hay credenciales de sandbox compartidas: obtené las tuyas en registro de developer.
- Token del SDK. Tu backend lo pide con
POST /api/v1/loginSdk. Ver autenticación. - Cargá el script. Ver instalación.
- Poné los inputs con los ids del contrato y el contenedor
responseTilopay. Ver campos del formulario. - Iniciá la compra con
Tilopay.Init()y mostrale al cliente los métodos de pago que devuelve. - Cerrá la compra con
Tilopay.startPayment(). El SDK maneja 3DS y renderiza el resultado en tu URL deredirect.
Antes de asumir que estás en pruebas#
Pruebas y producción comparten host: el modo se verifica con el campo test de Init(). Ver
entornos.
Cumplimiento#
Los datos de tarjeta no pasan por tu servidor, pero tu página los captura: consultá con tu equipo de cumplimiento el alcance que te corresponde.
Última verificación: 2026-08-28 · Responsable: equipo-integraciones