Hosted payment page

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

La operación de este camino está en API · processPayment.

Diferencia con un link de pago#

• Hosted payment page: tu servidor pide una URL de pago por API y redirige al cliente a ella. Es ideal para flujos de checkout integrados en tu sitio o app.
• Link de pago: es una URL reusable que creás por API o desde el panel y compartís por mensaje, correo, redes o QR. El cliente paga cuando quiera; no necesitás redirigirlo desde tu flujo.
• En resumen: HPP para checkout integrado y transacciones puntuales; link de pago para cobros compartidos y sin desarrollo de front.

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#

1. Credenciales propias. No hay credenciales de sandbox compartidas: cada desarrollador obtiene las suyas en registro de developer.
2. Autenticación del API. Ver autenticación.
3. 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.