Saltar al contenido
Crear cuenta

Documentación

Envío por correo

Además de compartir la URL, puedes pedir a Pagos Express que envíe el enlace por correo a tu cliente y seguir la entrega.

Enviar el enlace

POST /v1/payment_links/{id}/email
Authorization: Bearer sk_test_...
Idempotency-Key: 2c9d…
Content-Type: application/json

{ "to": "cliente@ejemplo.com" }

→ 202 Accepted
{ "object": "payment_link_email", "id": "eml_…", "status": "queued", "to": "cliente@ejemplo.com", … }
  • to es obligatorio y explícito: el destinatario no se infiere del enlace.
  • Idempotency-Key es obligatorio. Reutilízalo en reintentos para no enviar dos correos.
  • 202 significa en cola, no entregado. La entrega la hace un worker y la confirma el proveedor de correo.
  • En modo pruebas la entrega se simula: no sale ningún correo real y el registro termina en simulated.

Permiso del usuario

Si el envío lo pide un agente por MCP, el alcance OAuth pagos:email es obligatorio y el usuario debe haberlo aceptado en la pantalla de consentimiento.

Historial de entregas

GET /v1/payment_links/{id}/emails devuelve las últimas 50 entregas del enlace con su estado. Antes de reenviar un resultado dudoso, revisa este historial: un estado unknown no debe reenviarse automáticamente.