Saltar al contenido principal
Un agente de IA puede hacer toda la conexión entre tu web y Gudink. Esta página tiene lo que le tenés que dar, las instrucciones para pegarle y cómo comprobar que quedó bien.

Antes de empezar

Necesitás tres cosas, todas en tu cuenta de Gudink de siempre:
  1. Tu cuenta, con el email verificado y los datos de facturación completos.
  2. Al menos un producto diseñado, que es lo que tu web va a vender.
  3. Una clave. La creás vos en tu panel, en Integraciones > API, sin pedir acceso. Empieza con gk_live_ y se muestra una sola vez.
El agente prueba con tu cuenta real, sin riesgo: un pedido creado por API no se produce ni se cobra hasta que lo pagás vos desde tu panel. Ver Probar sin pagar.

Cómo darle la clave al agente

La clave es una contraseña de tu cuenta: crea pedidos que se te cobran.
  • No la pegues en el chat. Guardala como variable de entorno en tu servidor o en el archivo de secretos de tu proyecto, y decile al agente el nombre de la variable (GUDINK_API_KEY).
  • Lo mismo con el secreto de los avisos (GUDINK_WEBHOOK_SECRET).
  • La URL base va en otra variable (GUDINK_API_BASE), para que nunca quede escrita en el código.
  • Si la pegaste en algún lado sin querer, revocala desde el panel y creá otra. Revocar es inmediato.

Instrucciones para pegarle al agente

Copiá este bloque tal cual. Completá las dos líneas del final.

Qué tenés que hacer vos, no el agente

Hay pasos que se hacen desde tu panel de Gudink y que el agente no puede hacer por vos:
  1. Diseñar los productos y crear la clave en Integraciones > API.
  2. Dar de alta el destino de avisos en Integraciones > API > Avisos, con la URL del endpoint que armó el agente. Ahí te muestran el secreto de firma, una sola vez. Si el agente trabaja en tu máquina, la URL tiene que ser la de un túnel https con nombre de host público: Gudink no puede mandar avisos a localhost.
  3. Apretar “Mandar prueba” para comprobar el endpoint.
  4. Ver los estados que vienen después del pago, si querés: pagá un pedido real, por ejemplo una muestra para vos con tu dirección. El agente no paga pedidos.
  5. Pagar los pedidos, cuando empieces a vender. Cada pedido que entra por la API lo pagás desde tu panel. Tenés 72 horas: si no, se cancela aunque tu comprador ya te haya pagado. Es una tarea de todos los días; ver Pagar es una tarea de todos los días.

Cómo saber que quedó bien

Pedile al agente que te muestre cada uno de estos puntos funcionando, con pedidos de prueba sin pagar:
  1. GET /me responde con tu cuenta y billing_complete es true.
  2. El catálogo de tu web muestra tus productos de Gudink, con las imágenes alojadas en tu sitio.
  3. El checkout muestra las opciones de envío con su precio para un código postal real. Si ofrecés retiro en sucursal, también la lista de sucursales, y un pedido de prueba con retiro llega a tu panel con la sucursal elegida (ver Retiro en sucursal).
  4. Un pedido de prueba aparece en tu panel como “pendiente de pago”, con el nombre y la dirección de tu comprador.
  5. Repetir el mismo pedido (mismo external_id, mismo cuerpo) no crea otro.
  6. “Mandar prueba” en el panel llega a tu endpoint y la firma verifica.
  7. Cancelar un pedido de prueba sin pagar llega a tu sistema como order.cancelled con cancel_reason: "cancelled_by_seller", y repetir ese mismo pedido devuelve el pedido cancelado, que tu sistema no confirma.
  8. Con avisos order.paid, order.shipped y order.delivered firmados con el vector de prueba, tu sistema se entera de cada cambio de estado y guarda el número de seguimiento.
  9. No queda ningún pedido de prueba sin cancelar en tu panel.
El detalle de cada paso está en el recorrido de prueba de punta a punta. Si alguno falla, pasale al agente el error.code que recibió y la página Errores y límites.

Para el agente: cómo leer esta documentación

Hay una sola guía canónica y un solo contrato. Los dos los sirve la propia API, sin clave:

Si tu agente usa MCP

Este centro de ayuda tiene un servidor MCP de sólo lectura para buscar y leer la documentación sin salir del editor. No pide clave.
En Claude Code se agrega con una línea; en Cursor, Codex u otro cliente, cargá esa URL como servidor MCP por HTTP:
Sirve para que el agente consulte la documentación mientras programa. No crea pedidos ni toca tu cuenta: eso lo hace tu servidor con la API y tu clave.