Crear link de pago recurrente

Un link recurrente agrupa hasta 5 planes (precios por ciclo) y permite cobrar automáticamente cada período. El comprador elige un plan en url y paga en el checkout de Polar; a partir de ahí Polar cobra la suscripción cada ciclo.

El link y sus planes se crean en Polar, el Merchant of Record: Polar cobra cada ciclo, calcula el impuesto y acredita cada renovación en tu saldo de Polar. Necesitas Polar conectado (si no, 400 account_not_connected). Ver Suscripciones.

Request

POST /api/v1/payment-links

Headers

Body

Cada elemento de prices

Planes por asientos

Con pricing_type: "per_seat" el plan admite tres formas de precio:

La matriz de seat_tiers arranca en el primer asiento y el último tramo siempre es abierto (up_to: null). En graduated cada tramo se suma a los anteriores; en volume la tasa del tramo alcanzado se aplica a todos los asientos. Máximo 10 tramos. Cada tramo lleva unit_amount (por asiento) o flat_amount (cargo fijo del tramo), en centavos:

{
  "amount": 0,
  "interval": "month",
  "pricing_type": "per_seat",
  "tiers_mode": "graduated",
  "seat_tiers": [
    { "up_to": 5,    "unit_amount": 900 },
    { "up_to": 20,   "unit_amount": 700 },
    { "up_to": null, "unit_amount": 500 }
  ]
}

Con esa matriz (graduated), 3 asientos cuestan USD 27, 10 cuestan USD 80 y 30 cuestan USD 200.

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://buy.polar.sh/polar_cl_...",
  "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"
}

checkoutUrl es el checkout de Polar del link. El comprador también puede elegir el plan desde url, 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; de los planes existentes se editan el precio, el nombre y la prueba gratis. Agregar o quitar planes, o cambiar el intervalo o los asientos, exige un link nuevo (ver Listar y gestionar links).

Errores