REST /v1
La misma API que usa tu agente
Crea un enlace, comparte la URL y confirma el pago cuando el estado sea succeeded. Convenciones al estilo Stripe: Bearer, idempotencia, paginación por cursor y errores problem+json.
Qué puedes hacer
- Crear un enlace de cobro con conceptos e importe fijo
- Listar y consultar enlaces y pagos
- Desactivar un enlace (no reembolsa)
- Sincronizar un pago con su pasarela
- Pedir el envío del link por correo
- Ver si Stripe o eCart Pay están conectados
Importes en centavos
Los montos son enteros en unidades menores. Para MXN, MX$1,500.00 = 150000. Un total por debajo del mínimo de Stripe (MX$10.00) o por encima de su máximo se rechaza al crear el enlace, no en el checkout.
Crear un enlace
Sustituye la clave de prueba. Conserva la misma Idempotency-Key si reintentas la misma operación.
curl https://api.pagos.express/v1/payment_links \
-H "Authorization: Bearer sk_test_..." \
-H "Idempotency-Key: order-1042" \
-H "Content-Type: application/json" \
-d '{"title":"Consultoría","items":[{"name":"Sesión","quantity":1,"unitPriceCentavos":150000}],"currency":"MXN"}'La respuesta incluye url: esa es la página pública que compartes. Crear el enlace no cobra a nadie.
Referencia viva
Referencia interactiva en pagos.express/docs/api y el documento OpenAPI en https://api.pagos.express/openapi.json.
Prueba con sk_test_
El modo de pruebas es gratis. Cuando pases a sk_live_ necesitas perfil verificado y suscripción activa.
Preguntas frecuentes
- ¿Dónde está la referencia OpenAPI?
- Las guías viven en https://pagos.express/docs y la referencia interactiva en https://pagos.express/docs/api. El contrato publicable es https://api.pagos.express/openapi.json: solo operaciones /v1, un esquema de autenticación y las formas que esas rutas usan.
- ¿Cómo se expresan los importes en MXN?
- En unidades menores enteras: centavos. MX$1,500.00 se envía como 150000. La moneda por defecto es MXN. No inventes impuestos ni totales; manda los conceptos que vas a cobrar.
- ¿La API y el MCP hacen lo mismo?
- Sí. Cada herramienta MCP reentra al handler /v1 correspondiente. Misma autenticación por cuenta, mismo modo test/live, misma idempotencia.
- ¿Puedo conectar Stripe por API?
- No. Conectar o reconectar el proveedor es una acción del propietario en el dashboard. La API solo lee GET /v1/connections para saber si hay una conexión activa.