Crear un plan

post/v1/plans

Define la cadencia y el monto de un cobro recurrente.

Request

BASH

curl -X POST https://api.cauril.com/v1/plans \
  -H "Authorization: Bearer sk_test_..." \
  -H "Idempotency-Key: $(uuidgen)" \
  -H "Content-Type: application/json" \
  -d '{
    "amount": 5000,
    "currency": "USD",
    "interval": "day",
    "interval_count": 1,
    "trial_days": 0,
    "metadata": {}
  }'

Cuerpo CreatePlan

amountreq	Money
currencyreq	Currency
intervalreq	BillingInterval
interval_count	integer	Número de intervalos por período de cobro. Default: `1`.
trial_days	integer
metadata	object

Respuestas

201	Plan creado	Plan
400	Error	Error
422	Error	Error

Ejemplo de respuesta · 201

JSON

{
  "object": "plan",
  "id": "plan_01J...",
  "amount": 5000,
  "currency": "USD",
  "interval": "day",
  "interval_count": 0,
  "trial_days": null,
  "metadata": {},
  "created_at": "2026-06-01T12:00:00Z"
}