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
Paso 1: Generar las claves del iframe
Paso 1: Generar las claves del iframe
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.
Paso 2: Crear la sesión de pago
Paso 2: Crear la sesión de pago
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 cuerpopublicKey- Tu clave pública del iframe
redirectUrl de tu iframe.Paso 3: Incrustar el iframe
Paso 3: Incrustar el 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.

