SDK JavaScript

SDK v2

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

  1. Credenciales. No hay credenciales de sandbox compartidas: obtené las tuyas en registro de developer.
  2. Token del SDK. Tu backend lo pide con POST /api/v1/loginSdk. Ver autenticación.
  3. Cargá el script. Ver instalación.
  4. Poné los inputs con los ids del contrato y el contenedor responseTilopay. Ver campos del formulario.
  5. Iniciá la compra con Tilopay.Init() y mostrale al cliente los métodos de pago que devuelve.
  6. Cerrá la compra con Tilopay.startPayment(). El SDK maneja 3DS y renderiza el resultado en tu URL de redirect.

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

Ver como Markdown crudo