Saltar al contenido principal
Esta guía ofrece un proceso detallado paso a paso para integrar Smart Fields en tu proceso de pago. Al finalizar, podrás recopilar de forma segura los datos de pago directamente en tu sitio web, mientras que Localpayment se encarga de la información confidencial.

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

  1. Incluir el SDK de Smart Fields

Elige el entorno adecuado para tu integración:
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.

  1. Inicializar el SDK

Inicializa el SDK con tus credenciales una vez que se cargue el script:
Parámetros de configuración:

  1. 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.

  1. Configurar formulario de pago

Crea la estructura HTML para tu formulario de pago:

  1. Crear y montar campos de pago

Inicializa los campos de pago seguro e incorpóralos a tu formulario:
Utiliza el método 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:

  1. 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:

  1. Procesar el envío del pago

Recuperar los datos de la sesión y el ID de sesión:

  1. 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:
Respuesta de consolidación prevista:

  1. 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.

Última modificación el 10 de noviembre de 2026