Skip to main content
Puedes mostrar el portal de pagos dentro de tu propio sitio con un iframe, en lugar de enviar al usuario a app.tapipay.la. El usuario ve sus deudas y paga sin salir de tu página.

Iframe mínimo

Eso es todo lo que necesitas. El src sigue la misma estructura que una liga de pago, así que también puedes identificar tu empresa por companyCode:

Los atributos que importan

"payment"
Habilita la Payment Request API dentro del iframe, que es la que usan los medios tipo wallet. El SDK lo pone siempre, así que conviene ponerlo también en un iframe a mano para tener el mismo comportamiento.
number
El iframe no ajusta su alto solo. Elige un valor que acomode la lista de deudas más larga que esperas (700px es un punto de partida razonable) o resuelve el alto con el SDK, que sí lo ajusta de forma automática.
string
predeterminado:"100%"
Con 100% el portal se adapta al ancho de su contenedor. El portal es responsive: verifica cómo se ve en móvil y en escritorio.

Iframe o SDK

El iframe manual es la vía más simple, pero el SDK resuelve por ti cosas que a mano no tienes:
Usa el iframe manual si quieres el portal completo (lista de deudas incluida) dentro de una página estática. Usa el SDK si necesitas reaccionar al pago desde tu código, si estás en una SPA, o si quieres mostrar solo el paso de medios de pago.

Consideraciones

Usa el dominio app.tapipay.la en el src. Los dominios www.tapipay.la y tapipay.la redirigen ahí, y una redirección dentro de un iframe agrega latencia al primer render.
  • Un iframe por usuario. El identifierValue del src determina de quién son las deudas que se muestran. Ármalo en tu servidor con el identificador del usuario que tiene la sesión abierta.
  • Sin credenciales en el src. La URL del portal no lleva tokens ni API keys. No agregues las tuyas: el portal es una pantalla pública que resuelve el acceso por el identificador.