Crear link de pago recurrente

Un link recurrente agrupa hasta 5 planes (precios por ciclo) y cobra automáticamente cada período. El comprador elige un plan en url y paga en el checkout; a partir de ahí la suscripción se renueva sola cada ciclo, en USD, y cada renovación se acredita en tu saldo como una venta nueva.

Necesitas la cuenta de cobro activada (si no, 409 payment_account_not_ready). Ver Suscripciones.

Request

POST /api/v1/payment-links

Headers

Body

Cada elemento de prices

Planes gratis, asientos y pruebas

• Planes gratis: cada plan vale al menos USD 4. Un plan con amount: 0 responde 400 unsupported_plan y no se crea nada.
• Precio por asiento: una suscripción es siempre de una unidad. pricing_type: "per_seat" (o cualquier campo de asientos) responde 400 unsupported_plan. Para equipos, crea un plan por tamaño (por ejemplo "Equipo 5" y "Equipo 10").
• Prueba gratis: al suscribirse con prueba, el comprador deja su tarjeta y se registra una venta de USD 0 (billingReason: "subscription_create"); el primer cobro real llega al terminar la prueba.

Ejemplo

curl https://api.vexorpay.com/api/v1/payment-links \
  -X POST \
  -H "Authorization: Bearer vxp_live_tu_clave" \
  -H "Content-Type: application/json" \
  -d '{
    "type": "recurring",
    "title": "Membresía Vexor",
    "reference": "MEMBRESIA",
    "prices": [
      {
        "amount": 9,
        "interval": "month",
        "description": "Mensual"
      },
      {
        "amount": 90,
        "interval": "year",
        "trial_period_days": 7,
        "description": "Anual"
      }
    ]
  }'

Respuesta exitosa

201 Created

{
  "id": "66f1c1e2c8a4b0d1f2e3a4b6",
  "amountCents": 0,
  "currency": "usd",
  "title": "Membresía Vexor",
  "description": null,
  "image": null,
  "reference": "MEMBRESIA",
  "metadata": null,
  "status": "active",
  "slug": "b2c3d4e5f6",
  "sandbox": false,
  "url": "https://www.vexorpay.com/p/b2c3d4e5f6",
  "checkoutUrl": "https://…",
  "type": "recurring",
  "prices": [
    {
      "id": "66f1c1e2c8a4b0d1f2e3a4c1",
      "amountCents": 900,
      "currency": "usd",
      "interval": "month",
      "intervalCount": 1,
      "trialPeriodDays": null,
      "description": "Mensual",
      "isDefault": true
    },
    {
      "id": "66f1c1e2c8a4b0d1f2e3a4c2",
      "amountCents": 9000,
      "currency": "usd",
      "interval": "year",
      "intervalCount": 1,
      "trialPeriodDays": 7,
      "description": "Anual",
      "isDefault": false
    }
  ],
  "createdAt": "2026-01-02T12:00:00.000Z",
  "updatedAt": "2026-01-02T12:00:00.000Z"
}

El comprador elige el plan desde url (la página pública del link), o puedes llevarlo directo a un plan con POST /v1/payment-links/{id}/checkout y price_id. El tipo del link no se puede cambiar con PATCH, y de los planes existentes solo se edita el nombre (description): cambiar el precio, el intervalo, la prueba gratis o la cantidad de planes exige un link nuevo (ver Listar y gestionar links).

Errores