Saltar al contenido

Blog · 11 de septiembre de 2026

Cómo cobrar con un agente de IA

Del “créame un cobro de mil quinientos pesos” a la URL que paga tu cliente: qué conectar, qué autorizar y cómo saber que ya pagaron.
Agente de IA de Pagos Express

Antes de empezar

  1. Una cuenta en Pagos Express con Stripe o eCart Pay conectado en modo pruebas (en Conexiones).
  2. La URL del servidor MCP de pruebas: https://api.pagos.express/mcp/test. La de en vivo, https://api.pagos.express/mcp, la usas solo cuando ya cobras de verdad.
  3. Una credencial. Recomendado: OAuth, el cliente te lleva a iniciar sesión y a una pantalla de consentimiento. Alternativa: una clave sk_test_ creada en API y MCP, que se muestra una sola vez.

Conectar el cliente

  • Claude (web o escritorio): agrega un conector MCP remoto con la URL de pruebas. Claude descubre OAuth por su cuenta; inicias sesión en Pagos Express y aceptas los permisos.
  • ChatGPT: en la configuración de conectores o apps agrega un servidor MCP remoto con la misma URL y completa el OAuth.
  • Cursor y clientes que se configuran por archivo: en mcp.json declara el servidor con la URL y, si el cliente no hace OAuth, el encabezado Authorization: Bearer sk_test_…. La clave va en configuración secreta, nunca en el prompt.

Las rutas de menú cambian con cada versión de esos productos. Lo que no cambia es la receta: URL del servidor más OAuth o Bearer. La guía del servidor MCP tiene el ejemplo de configuración completo.

El primer cobro

Pide algo concreto: “Crea un enlace de cobro de MX$1,500 por ‘Sesión de consultoría’ para ana@ejemplo.com”. El agente llama create_payment_link con el importe en centavos (150000), una clave de idempotencia y los datos del cliente, y te devuelve la URL pública.

Crear el enlace no cobra a nadie. Tu cliente paga en esa página, en el checkout de Stripe. Si el agente se equivocó de importe, pídele que lo desactive y cree otro: los conceptos de un enlace no se editan.

Saber que ya pagaron

“¿Ya pagaron el enlace de Ana?” dispara get_payment_link o list_payments. Solo un pago en succeeded confirma fondos; pending significa que el checkout se abrió y nadie terminó. Ante una duda, sync_payment verifica directamente con la pasarela.

Si el cliente te transfirió por fuera, el agente puede registrarlo con mark_payment_link_paid, pero te pedirá confirmación antes: cierra el enlace y dispara los webhooks de pago.

Compartir por correo

“Envíaselo por correo” usa send_payment_link_email. Requiere que hayas aceptado el permiso de correo en la pantalla de consentimiento, y en modo pruebas no sale ningún correo real: el registro queda como simulated.

Lo que el agente no hace

No inicia el checkout del cliente, no reembolsa, no crea claves API, no conecta proveedores y no ve secretos. Cuando quieras, revoca su acceso en Agentes conectados; sus tokens dejan de funcionar al instante.

Pasar a en vivo

Perfil verificado, suscripción activa (MX$200 al mes, IVA incluido) y una pasarela conectada en modo en vivo. Cambia la URL a https://api.pagos.express/mcp o usa una clave sk_live_. El entorno lo fija la credencial: una clave de prueba contra el servidor en vivo recibe 403, así que no hay forma de mezclar cobros de juguete con dinero real.

Preguntas frecuentes

¿Necesito programar para cobrar con un agente?
No. Agregas el servidor MCP en tu cliente (Claude, ChatGPT, Cursor u otro), autorizas con OAuth o una clave de prueba y pides el cobro en lenguaje natural. El agente llama las herramientas por ti.
¿El agente puede cobrar la tarjeta de mi cliente?
No. El agente crea la solicitud de cobro y te da la URL. Tu cliente paga en la página pública, en el checkout de Stripe. Nadie escribe números de tarjeta en la conversación.
¿Cómo sé que ya pagaron?
Pídele al agente que consulte el enlace o los pagos. Solo el estado succeeded confirma fondos. También puedes registrar un webhook payment.succeeded en el dashboard.
¿Qué pasa si el agente se equivoca?
Crear un enlace no mueve dinero, así que puedes desactivarlo. Las herramientas piden confirmación antes de marcar un cobro como pagado o enviar correo, y puedes revocar el acceso del agente en Agentes conectados.