Hosted payment page
API v1Qué es#
Tu servidor le pide una URL de pago al API, redirige al cliente a esa página de Tilopay y recibe el resultado en tu callback URL.
Los datos de tarjeta se digitan en una página de Tilopay: el comercio nunca ve un número de tarjeta y el servidor del comercio queda fuera de ese flujo.
Las operaciones del API de este camino están en API · Hosted payment page.
Para quién es#
Para equipos que cobran con código propio pero prefieren no construir ni mantener el formulario de tarjeta. Lo que necesitás es backend: pedir la URL y atender el callback.
Requisitos antes de empezar#
- Credenciales propias. No hay credenciales de sandbox compartidas: cada desarrollador obtiene las suyas en registro de developer.
- Autenticación del API. Ver autenticación.
- Una URL de callback tuya que pueda recibir el resultado de la transacción.
Cómo confirmar el estado de un cobro#
El resultado que llega a tu callback no es la única señal disponible, y no todas las respuestas de error viajan con un HTTP 4xx:
- Leé cómo leer una respuesta de error antes de decidir un éxito.
- Configurá webhooks para los eventos que te interesen.
- Si una llamada falla sin respuesta clara, resolvé el estado con reintentos seguros.
Entornos#
Pruebas y producción comparten el mismo host. Ver entornos antes de cobrar de verdad.
Cumplimiento#
Es el camino que menos expone a tu infraestructura junto con el de sin código. Confirmá con tu equipo de cumplimiento el alcance que aplica a tu comercio.
Si preferís el formulario en tu sitio#
Usá el SDK JavaScript: el diseño es tuyo y los datos siguen sin pasar por tu servidor.
Última verificación: 2026-08-28 · Responsable: equipo-integraciones