Seguridad de las credenciales
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.compara Producción ohttps://ui.stage.localpayment.compara 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.
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
- Cargas útiles de webhook saneadas o ficticias (reemplaza los valores reales con marcadores de posición como
XXXXo 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.
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.
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
internalIdya 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.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.

