UUGate
← Volver a los tutoriales

Integración API

Integrar con la guía para asistentes de IA

Entrega la documentación completa y tus requisitos a un asistente de programación con IA, y valida solicitudes y callbacks.

Lectura de unos 3 minActualizado el 2026-09-24

Guía paso a paso

Sigue los pasos en tu propio panel. Haz clic en una imagen para ampliarla.

  1. Abre la documentación API desde la cabecera y entra en la guía de integración con IA. Usa Copiar documento completo o Descargar Markdown y entrega el documento completo a tu asistente. Un ejemplo aislado de un endpoint no contiene toda la especificación.

    Paso 1 · Haz clic para ampliar
  2. Indica el lenguaje, framework y versión de tu servidor, la tabla de pedidos, el flujo de cobro o pago y la ruta del callback. Pide primero un plan de cambios y un mapeo de campos. El asistente debe consultar las dudas antes de inventar campos o endpoints.

  3. Pide que implemente Merchant UID + API Key, firmas HMAC-SHA256, creación y consulta de pedidos, verificación de callbacks e idempotencia. Usa cadenas para los montos y aritmética decimal exacta. Las firmas de solicitudes y callbacks tienen formatos diferentes.

  4. Da preferencia al SDK oficial de Node.js o PHP / Laravel. En otros lenguajes, sigue la misma especificación de firma. Solicita plantillas de variables de entorno, instrucciones de instalación y pruebas. Sustituye los UID, montos y direcciones de ejemplo por los datos de tu negocio.

  5. Comparte solo documentación pública, valores de ejemplo y errores con datos sensibles ocultos. Configura tú mismo la clave real como UUGATE_API_KEY en el servidor; nunca la pegues en chats, código del navegador ni repositorios. Usa claves ficticias locales para probar firmas y callbacks duplicados.

  6. Consulta las guías de depuración de pedidos y callbacks. Compara parámetros y resultados entre la herramienta oficial y el código generado. Después valida errores, idempotencia persistente y tu receptor antes de conectar operaciones reales. El código generado también necesita pruebas de aceptación.

La integración con IA consiste en usar un asistente de programación para crear tu integración con UUGate. No requiere compartir la clave de pagos ni añadir una API de pagos especial para IA.

Instrucción para tu asistente de IA (sustituye los valores entre corchetes)

Usa la guía completa de integración con IA de UUGate que te proporciono como especificación de la API para integrar [cobros / wallets exclusivas / pagos individuales] en mi proyecto [lenguaje / framework / versión del servidor].
Primero describe el flujo, el mapeo de campos del pedido, la ruta del callback y las dudas que debes aclarar. Después escribe el código.
Lee la configuración desde UUGATE_BASE_URL, UUGATE_MERCHANT_UID y UUGATE_API_KEY. Usa valores de ejemplo; no solicites ni generes claves reales.
Implementa firmas, creación y consulta de pedidos, verificación del rawBody original del callback y transacciones de base de datos con restricciones únicas para evitar abonos duplicados. Valida comercio, pedido, moneda, monto y estado final.
Incluye instalación, plantillas de entorno, pruebas de callbacks válidos, alterados y duplicados, y diagnóstico de errores. No invoques automáticamente endpoints de pedidos o pagos en producción.

Ampliar captura