Saltar al contenido
Crear cuenta

Documentación

Documentación

Pagos Express crea enlaces de cobro que tu cliente paga en una página con tu marca. Esta documentación cubre la API REST, el servidor MCP y los webhooks. Todo lo que hace el dashboard se puede hacer por API.

URL base y convenciones

La API vive en https://api.pagos.express. Las rutas públicas empiezan con /v1. Las convenciones siguen el estilo de Stripe: claves secretas en Authorization: Bearer, Idempotency-Key en las creaciones, paginación por cursor con starting_after y errores en formato application/problem+json.

  • Los importes son enteros en unidades menores: 150000 son MX$1,500.00. Nunca envíes decimales.
  • Cada objeto trae livemode. Las claves sk_test_ nunca ven ni crean datos en vivo.
  • Las listas responden { "object": "list", "data": [...], "has_more": true }.

Primer cobro en cinco minutos

  1. Crea una cuenta y, en el dashboard, abre API y MCP. Crea una clave de prueba. Se muestra una sola vez.
  2. Conecta Stripe o eCart Pay en Conexiones en modo pruebas. Sin una conexión activa, la creación responde 409 no_active_connection. Si aún no tienes cuenta de eCart Pay, créala con nuestro enlace de partner.
  3. Crea el enlace:
Petición
curl https://api.pagos.express/v1/payment_links \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "title": "Consultoría septiembre",
    "items": [{ "name": "Sesión", "quantity": 1, "unitPriceCentavos": 150000 }],
    "currency": "MXN"
  }'
Respuesta 201
{
  "object": "payment_link",
  "id": "pl_…",
  "livemode": false,
  "status": "active",
  "url": "https://pagos.express/l/…",
  "amountCentavos": 150000,
  "currency": "MXN",
  "expiresAt": null,
  "metadata": {}
}

Comparte url con tu cliente. Crear el enlace no cobra a nadie: el pago ocurre en esa página, en el checkout alojado de la pasarela que elija (Stripe o eCart Pay).

  1. Confirma el pago con GET /v1/payment_links/{id} (estado paid) o con un webhook payment.succeeded. Solo un pago en succeeded confirma fondos; nunca confíes en la redirección del navegador.

Pruebas gratis, sin dinero real

Usa tarjetas de prueba de Stripe o del sandbox de eCart Pay en modo pruebas. Para cobrar en vivo necesitas perfil verificado, suscripción activa y una clave sk_live_.

¿Prefieres un agente?

Las mismas operaciones existen como herramientas MCP en https://api.pagos.express/mcp/test (pruebas) y https://api.pagos.express/mcp (en vivo). Cada herramienta reentra al mismo handler /v1, con la misma autenticación, aislamiento e idempotencia. Guía del servidor MCP.

Guías