Saltar al contenido principal
Directrices de seguridad para desarrolladores que utilizan herramientas de IA para crear integraciones de Localpayment. Protege tus credenciales, gestiona los datos de pago de forma responsable y revisa el código generado por IA antes de implementarlo en producción. Las herramientas de IA aceleran significativamente el desarrollo, pero en el contexto de los pagos, avanzar rápidamente sin medidas de seguridad conlleva riesgos reales. Las directrices de esta página te ayudarán a aprovechar las ventajas del desarrollo asistido por IA sin exponer tus credenciales, los datos de tus clientes ni tu entorno de producción a riesgos innecesarios.

Seguridad de las credenciales

Nunca pegues claves API, tokens de acceso ni credenciales secretas en una interfaz de chat de IA. La mayoría de los proveedores de IA registran las conversaciones, y las credenciales compartidas en un chat pueden almacenarse, indexarse o quedar expuestas.
Reglas a seguir:
  • Utiliza variables de entorno para todas las credenciales en el código generado por IA. Si la IA genera una clave codificada en un ejemplo, reemplázala inmediatamente.
  • Utiliza las credenciales de Stage cuando trabajes con IA durante el desarrollo y las pruebas. Las claves API de Stage son de bajo riesgo: no pueden mover dinero real.
  • Si compartes accidentalmente una clave API de Producción en una sesión de chat, rótala de inmediato desde el Business Portal de Localpayment (https://ui.v3.localpayment.com para Producción o https://ui.stage.localpayment.com para Stage) y audita tu historial reciente de transacciones.
  • No compartas secretos de webhook, tokens JWT ni ningún material de autenticación en las solicitudes, ni siquiera en un formato “sanitizado” que parezca obvio.
Patrón de credenciales seguras en código generado por IA:

Datos de clientes y pagos

No compartas datos de pago reales con herramientas de IA a menos que hayas verificado que los términos de procesamiento de datos del proveedor son compatibles con tus obligaciones de cumplimiento. Qué evitar pegar en chats de IA:
  • Datos reales del titular de la tarjeta (números de tarjeta, códigos CVV, fechas de vencimiento)
  • Información personal identificable (PII) real del cliente (números de identificación nacional, nombres completos combinados con datos de documentos)
  • Cargas útiles de webhook reales que contienen importes de transacciones reales y números de cuenta de producción.
  • Números de cuenta (CVU, CLABE, CCI) asociados a clientes reales
Qué es seguro:
  • Cargas útiles de webhook saneadas o ficticias (reemplaza los valores reales con marcadores de posición como XXXX o valores de ejemplo)
  • Códigos de error y códigos de estado sin el contexto de la transacción circundante.
  • Estructuras de solicitud de API con valores de ejemplo de la documentación.
Ejemplo: forma segura de solicitar ayuda para depurar webhooks:

Etapa previa a la producción

Siempre desarrolla y prueba tu integración asistida por IA en el entorno de preproducción antes de implementarla en producción.
El servidor MCP de Localpayment expone la documentación y la especificación de la API; no ejecuta solicitudes. Todas las llamadas a la API se realizan en tu propio código, utilizando tus credenciales. El riesgo ambiental depende completamente de las credenciales y la URL base que utilices en tu integración.
Ten en cuenta que algunas funciones solo están disponibles en producción (por ejemplo, la creación de alias de CVU en Argentina). La documentación de cada función indica explícitamente cuándo se aplica esta restricción.

Revisión del código generado por IA

El código generado por IA siempre debe revisarse antes de fusionarlo o implementarlo. En una integración de pagos, los errores pueden tener consecuencias financieras. Lista de verificación para revisar el código de integración de Localpayment generado por IA:
  • Sin credenciales codificadas — todas las claves API usan variables de entorno
  • URL base correcta — URL de Stage para desarrollo, URL de Producción para la implementación
  • externalId es único — el código genera identificadores únicos por transacción (p. ej., UUID). Los externalId duplicados provocarán el error 500.
  • Idempotencia del webhook — el manejador del webhook verifica si el internalId ya fue procesado antes de actuar
  • Respuesta HTTP 200 — el manejador del webhook siempre devuelve 200 OK después del procesamiento, incluso para los eventos que ignora
  • Solo HTTPS — todas las llamadas a la API usan HTTPS, nunca HTTP
  • Manejo de errores — los códigos de estado rechazados (5xx, 8xx, 9xx) se detectan y se gestionan, no se ignoran silenciosamente
  • Datos sensibles no registrados — las claves API, los datos de tarjetas y la PII de los clientes no se escriben en los registros

¿Qué datos puede ver Localpayment?

Cuando utilices cualquier herramienta de IA de Localpayment (servidor MCP, avisos del sistema del agente o esta documentación), es importante comprender exactamente a qué puede y no puede acceder Localpayment: El servidor MCP de Localpayment es un servidor de documentación pública de solo lectura. No tiene acceso a tu cuenta de comerciante de Localpayment, a tus transacciones ni a ningún dato que tengas almacenado en Localpayment. Solo ofrece la misma documentación disponible públicamente en https://docs.localpayment.com.

Políticas de datos de herramientas de IA

Comprender cómo tu proveedor de IA gestiona los datos que compartes forma parte del uso responsable.
Antes de utilizar cualquier herramienta de IA para procesar datos de clientes o transacciones, debes evaluar tus obligaciones conforme a las normativas de protección de datos y financieras aplicables en cada país donde operas. El uso de herramientas de IA para procesar datos personales, información financiera o datos de transacciones de pago puede requerir bases legales específicas, acuerdos de procesamiento de datos (APD) con el proveedor de IA y medidas de seguridad técnicas, según tu jurisdicción.Las normativas aplicables en cada país de operación incluyen, entre otras:
  • Argentina — Ley 25.326 de Protección de Datos Personales (LPDP) y normativa aplicable del BCRA
  • Brasil — Lei Geral de Proteção de Dados (LGPD — Lei 13.709/2018)
  • Colombia — Ley 1581 de 2012 (Habeas Data) y Decreto 1074 de 2015
  • México — Ley Federal de Protección de Datos Personales en Posesión de los Particulares (LFPDPPP) y su Reglamento
  • Perú — Ley 29733 de Protección de Datos Personales y su Reglamento (DS 003-2013-JUS)
  • Chile — Ley 19.628 sobre Protección de la Vida Privada (y modificaciones vigentes)
  • Ecuador — Ley Orgánica de Protección de Datos Personales (LOPDP)
  • Todos los mercados — PCI DSS v4.0 para cualquier procesamiento que involucre datos de tarjetas de pago
En todos los casos: (1) verifica que tu proveedor de IA haya firmado un Acuerdo de Procesamiento de Datos (APD) que cubra los tipos de datos específicos que pretendes compartir; (2) aplica la minimización de datos: comparte solo lo estrictamente necesario; (3) nunca compartas datos de titulares de tarjetas, documentos de identidad nacionales o números de cuentas financieras con ninguna herramienta de IA sin autorización legal explícita y controles técnicos apropiados.

Referencia rápida


Próximos pasos

Claves y entornos API

Gestiona tus credenciales de Stage y de Producción y comprende las diferencias entre los entornos.

Recibir notificaciones de pago

Implementar un manejo seguro e idempotente de webhooks para los eventos de pago de Localpayment.
Última modificación el 10 de noviembre de 2026