Integraciones
Conéctate a tu manera: API, páginas alojadas o sin código
Elige el camino que encaja con tu equipo y tu alcance PCI. Construye sobre la API REST, usa un checkout alojado, envía un Payment Link o sube un lote en el Business Portal, y deja que tu herramienta de código con IA lea el contrato real.
- API REST
- Sandbox Stage
- Webhooks firmados
- Servidor MCP público
API RESTSiete caminos
Elige cómo te conectas
Detrás de cada camino están las mismas cuentas, saldos y reportes, así que puedes empezar liviano y sumar más después.
API REST directaMás flexible
Control total sobre cobros, payouts, cuentas virtuales, FX y reportes. JSON sobre HTTPS, llamado desde tu servidor, con webhooks firmados en cada cambio de estado.
API REST directa —WebCheckout alojadoSin código
Envía a tus clientes a un checkout alojado por Localpayment con los métodos locales que habilites. Sin código de front-end que mantener.
WebCheckout alojado —Payment LinksSin código
Crea un enlace en el Business Portal y compártelo por correo, SMS o redes. Ideal para facturas, ventas remotas y cobros puntuales.
Payment Links —iframe embebidoMarca blanca
Coloca un checkout de marca blanca dentro de tu propia página y conserva tu marca alrededor, con un alcance PCI reducido.
iframe embebido —SDK JS Smart FieldsFormulario propio
Campos de tarjeta alojados que se tokenizan en el navegador y se consolidan en un token de un solo uso que tu servidor luego cobra. Tú controlas el diseño del formulario.
SDK JS Smart Fields —Lotes en Business PortalOperaciones
Sube archivos de payouts y de cuentas virtuales y sigue los resultados en el portal. Sin trabajo de integración para finanzas y operaciones.
Lotes en Business Portal —Servidor MCP para IACon IA
Un servidor MCP público de solo lectura y llms.txt permiten que Cursor, VS Code, Claude y otros asistentes construyan sobre la API documentada.
Servidor MCP para IA —
Compara
Esfuerzo, alcance PCI y mejor uso
Una guía para preseleccionar. Tu alcance PCI final depende de cómo captures y almacenes los datos de tarjeta; confírmalo con tu evaluador.
API REST directa
- Esfuerzo
- Alto: desarrollo en servidor
- Alcance PCI
- Depende de cómo captures los datos de tarjeta; combínala con Smart Fields o una opción alojada
- Ideal para
- Plataformas que necesitan control total de cobros, payouts y FX
WebCheckout alojado
- Esfuerzo
- Bajo: redirección
- Alcance PCI
- Mínimo
- Ideal para
- Equipos que quieren métodos locales activos rápido
Payment Links
- Esfuerzo
- Muy bajo: sin código
- Alcance PCI
- Mínimo
- Ideal para
- Facturas, ventas remotas, cobros puntuales
iframe embebido
- Esfuerzo
- Bajo a medio
- Alcance PCI
- Reducido
- Ideal para
- Checkout con tu marca sin manejar campos de tarjeta
SDK JS Smart Fields
- Esfuerzo
- Medio: front-end y servidor
- Alcance PCI
- Compartido
- Ideal para
- Diseño de checkout propio con campos de tarjeta alojados
Lotes en Business Portal
- Esfuerzo
- Muy bajo: carga de archivo
- Alcance PCI
- Sin datos de tarjeta
- Ideal para
- Finanzas y operaciones que ejecutan payouts y cuentas virtuales
Servidor MCP para IA
- Esfuerzo
- Bajo: agregar una URL
- Alcance PCI
- No aplica: sin datos de pago
- Ideal para
- Ingenieros que usan asistentes de código con IA
Las credenciales del sandbox (Stage) se entregan al inicio de la alianza. El acceso a producción llega tras las pruebas, una revisión de seguridad y la verificación de negocio.
La API en la práctica
Un cobro típico por API, de punta a punta
Cuatro partes, seis pasos. Tu backend solo habla con una API; el riel local lo resolvemos por ti.
- 1
Backend del comercioAPI de Localpayment:
Autenticar
POST /api/token/ devuelve un token de acceso de corta vida. Las llamadas salen de tu servidor, desde una IP autorizada.
- 2
Backend del comercioAPI de Localpayment:
Crear el cobro
POST /api/payin/ con tu propio externalId, país, moneda, monto y método de pago.
- 3
API de LocalpaymentRiel local:
Enrutar al riel local
Localpayment envía la solicitud por el riel que habilitaste, como Pix, SPEI o PSE.
- 4
Riel localAPI de Localpayment:
El cliente paga
El riel confirma el pago. Los rieles en tiempo real confirman en segundos, 24/7.
- 5
API de LocalpaymentEndpoint de webhooks:
Webhook firmado
Un webhook con el encabezado X-Signature HMAC-SHA256 anuncia el nuevo estado.
- 6
Endpoint de webhooksBackend del comercio:
Verificar y actualizar
Valida la firma, deduplica por externalId o internalId, responde 200 y actualiza el pedido.
Ilustración simplificada con datos ficticios. Consulta el quickstart para ver los campos exactos de solicitud y respuesta.
Sal a producción
Del acuerdo firmado a producción
Recibe credenciales Stage
Las credenciales del sandbox llegan al inicio de la alianza, para que ingeniería empiece mientras corre la revisión de cumplimiento.
Construye y prueba en Stage
Stage replica producción sin dinero real. Usa tarjetas de prueba, el simulador de cuentas virtuales y la colección de Postman.
Revisión y verificación
Las credenciales de producción llegan tras completar las pruebas, una revisión de seguridad y la verificación de negocio.
Sal en vivo en semanas
Cambia la URL base y las credenciales, autoriza tus IP y empieza. Los nuevos mercados se habilitan por configuración, sin reintegrar.
Preguntas frecuentes
Preguntas sobre integración
¿Con qué camino conviene empezar?
Si necesitas control y tienes ingenieros, empieza con la API REST. Si quieres métodos locales activos rápido, usa WebCheckout o Payment Links. Puedes combinar caminos en la misma cuenta.
¿Ofrecen SDK de servidor?
No hay SDK de servidor oficiales. La API REST es JSON sobre HTTPS y la documentación muestra ejemplos en cURL y Node.js. El único SDK es el SDK JS Smart Fields, del lado del cliente.
¿Cómo se protegen las llamadas a la API?
Las llamadas usan HTTPS desde entornos de servidor con tokens Bearer y requieren autorizar las IP. Los webhooks se firman con HMAC-SHA256 para que verifiques que vienen de Localpayment.
¿Cómo evitamos cobros duplicados?
Envía tu propio externalId único en cada transacción. Un duplicado devuelve HTTP 409, y quien consume webhooks debe deduplicar por externalId o internalId.
¿Cómo afecta esto nuestro alcance PCI?
Depende del camino. WebCheckout alojado y Payment Links mantienen el alcance mínimo, el iframe embebido lo reduce y Smart Fields lo comparte. Confirma el resultado con tu evaluador.
¿Cómo ayudan las herramientas de código con IA?
Agrega el servidor MCP público de solo lectura en docs.localpayment.com/mcp a Cursor, VS Code, Claude u otras herramientas. Así leen la API documentada en lugar de adivinar.
¿Cuánto tarda la integración?
Las credenciales Stage llegan al inicio de la alianza y salir en vivo toma semanas, según el camino y tus ciclos de revisión. Habla con ventas para un plan a tu medida.
Empieza a construir hoy
Cuéntanos tus mercados y tu stack. Te recomendaremos el camino de integración y prepararemos tus credenciales Stage.