Requisitos previos
Asegúrate de tener listos estos componentes esenciales:Claves API
Obtén tus claves de autenticación desde el entorno de pruebas (Stage) o el de producción.
Código de cliente
Tu identificador único de comerciante que se encuentra en el Business Portal de Localpayment.
Configuración del backend
Un endpoint de servidor listo para recibir tokens de pago y procesar transacciones.
Pasos de integración
- Incluir el SDK de Smart Fields
Elige el entorno adecuado para tu integración:
- Stage (Pruebas)
- Producción (en vivo)
Utiliza esto para el desarrollo y las pruebas con pagos simulados:
Consejo
Siempre prueba tu integración a fondo en el entorno de pruebas antes de tu lanzamiento oficial.
Siempre prueba tu integración a fondo en el entorno de pruebas antes de tu lanzamiento oficial.
- Inicializar el SDK
Inicializa el SDK con tus credenciales una vez que se cargue el script:
- Crear una sesión segura
Establece una conexión segura con los servidores de Localpayment:
Nota de seguridadLa sesión establece canales de comunicación cifrados para todos los datos de pago.
- Configurar formulario de pago
Crea la estructura HTML para tu formulario de pago:
- Crear y montar campos de pago
Inicializa los campos de pago seguro e incorpóralos a tu formulario:
mount() para renderizar el iframe seguro dentro del contenedor especificado. Pasa una cadena de selector CSS que identifique el elemento DOM de destino (por ejemplo, #pan-container).
Tipos y características de los campos:
- Gestionar eventos de campo y validación
Escucha los eventos de cada campo para actualizar tu interfaz de usuario y realizar un seguimiento de su estado de validación:
- Procesar el envío del pago
Recuperar los datos de la sesión y el ID de sesión:
- Consolidar sesión y obtener token
Crea una solicitud POST al endpoint Consolidate, enviando el sessionId y los datos del titular de la tarjeta:
Entornos:
- Stage:
- Producción:
- Procesar el pago
Crea un nuevo Payin y usa el parámetro token en lugar de la información del titular de la tarjeta. El token representa de forma segura el método de pago sin exponer datos confidenciales.
Recursos y próximos pasos
Maximiza el éxito de tu integración con estos recursos esenciales.Integración de webhooks
Configura notificaciones en tiempo real para las actualizaciones del estado de las transacciones.
Portal de informes empresariales
Accede a análisis detallados, herramientas de generación de informes y funciones de conciliación.
Monitoreo de transacciones
Aprende a consultar el estado de las transacciones e implementar un seguimiento exhaustivo.
Referencia de la API
Documentación completa del endpoint con ejemplos interactivos.
Consejo profesionalSiempre prueba tu flujo de trabajo en nuestro entorno de pruebas antes de implementarlo en producción. Esto garantiza que el manejo de errores, el procesamiento de webhooks y el seguimiento del estado funcionen correctamente en todos los escenarios.
¿Necesitas ayuda?Ponte en contacto con nuestro equipo de soporte si experimentas algún problema o necesitas ayuda con la integración.

