Saltar al contenido principal
Integra sin fisuras un checkout de marca blanca en tu sitio web. El iFrame incrustado ofrece el procesamiento de pagos seguro de Localpayment y, al mismo tiempo, preserva la identidad de tu marca. La opción de Iframe incrustado te permite integrar sin fisuras la experiencia de checkout segura de Localpayment directamente en tu sitio web o aplicación. Esta solución ofrece una interfaz completa de procesamiento de pagos y mantiene la apariencia de tu marca.

Beneficios clave

Integración flexible y segura para tu marca

Mantén la coherencia de marca con iframes personalizables que se integran sin fisuras en tu checkout. Evita las redirecciones de página y garantiza un recorrido sin fricciones, sin comprometer la experiencia de usuario

Implementación rápida

Implementa métodos de pago locales e internacionales sin construir ni mantener una infraestructura de frontend compleja. Nuestro iframe te permite salir a producción en minutos, acelerando los esfuerzos de expansión y reduciendo la dependencia del equipo de ingeniería.

Menores costos de mantenimiento

Como el iframe es alojado y mantenido por Localpayment, tú te beneficias de actualizaciones continuas sin ningún impacto en tu implementación.

Cumplimiento y gestión de riesgos simplificados

Mantén los datos de pago sensibles fuera de tus servidores y reduce tu alcance de PCI. Con el iframe, los comerciantes trasladan a Localpayment tanto la responsabilidad de seguridad como la responsabilidad de cumplimiento.

Casos de uso

La solución de Iframe incrustado se adapta prácticamente a cualquier escenario de pago. Estas son las implementaciones más comunes:
  • Comercio electrónico y retail: Procesa compras en línea sin formularios de pago personalizados.
  • Industrias de servicios: Cobra honorarios por servicios profesionales y consultas.
  • Eventos y entretenimiento: Recintos de conciertos que venden entradas para eventos.
  • Organizaciones sin fines de lucro y comunidad: Organizaciones benéficas que recaudan donaciones en línea.

Proceso de integración

Qué hará: Crea en tu Business Portal de Localpayment las claves del iframe que autentican tu integración.Importante: Almacena tu clave privada de forma segura en tu servidor; nunca la expongas en código del lado del cliente. Tu clave pública se puede usar con seguridad en aplicaciones de frontend.Recursos: Sigue nuestro tutorial de claves de iframe detallado para obtener instrucciones paso a paso.
Qué sucede: Genera un token de sesión seguro mediante una solicitud del lado del servidor a nuestro endpoint de la API.Endpoint: POST https://api.stage.localpayment.com/bff/webcheckout/createsessionParámetros requeridos:
  • bodyMessage - Los datos de tu solicitud de pago (mismo formato que la API de Payin)
  • signature - Firma RSA de tu mensaje del cuerpo
  • publicKey - Tu clave pública del iframe
Respuesta: Recibirás un token de sesión que contiene la redirectUrl de tu iframe.
Qué hará: Establece la URL de origen del iframe usando la redirectUrl de la respuesta de tu sesión.Implementación: Simplemente asigna la redirectUrl al atributo src de tu iframe y la interfaz de checkout se cargará dentro de tu página.Resultado: Los usuarios pueden completar su pago sin salir de tu sitio web.

Confirmaciones por método de pago

Comprender qué sucede después del envío del pago te ayuda a establecer las expectativas adecuadas de los usuarios:

Confirmación instantánea

Tarjetas de crédito y débito
  • Confirmación de pago inmediata
  • Procesamiento de transacciones en tiempo real
  • Notificación instantánea de éxito o fallo

Instrucciones de pago

Transferencia bancaria
  • Instrucciones de pago detalladas
  • Números de referencia proporcionados
  • Plazos de pago especificados

Implementación de seguridad

Generación de la firma RSA

Todas las solicitudes deben incluir una firma RSA válida por motivos de seguridad. Así se genera una:

Mejores prácticas

  • Procesamiento del lado del servidor: Crea siempre las sesiones y las firmas en tu backend.
  • Gestión de claves: Almacena las claves privadas de forma segura y rótalas con regularidad.
  • Solo HTTPS: Asegúrate de que toda la comunicación se realice mediante conexiones seguras.
  • Validación de entradas: Valida todos los datos de pago antes de enviarlos a nuestra API.

Ejemplo de implementación

Descarga nuestro ejemplo de integración completo para ver cómo funcionan en conjunto todas las piezas:

Ejemplo completo de integración de iframe


¿Necesitas ayuda?Ponte en contacto con nuestro equipo de soporte si experimentas algún problema o necesitas ayuda con la integración.

Última modificación el 10 de noviembre de 2026