Crear un Plan
Tu clave API privada (comienza con pvk_)
In: header
Tu ID de organización
In: header
Si el plan está activo
Si el descuento también aplica sobre los items adicionales
Número de cuotas: cuántos ciclos se cobra la suscripción antes de cancelarse sola. Entero de 1 a 999; omitir para cobrar sin límite. Solo para planes recurrentes: enviarlo en un plan one_time devuelve 400
value <= 999Descripción del plan
1 <= length <= 1000Identificador externo para integración con otros sistemas
length <= 255"hourly" | "daily" | "weekly" | "biweekly" | "monthly" | "quarterly" | "semiannual" | "annual"Si los impuestos están incluidos en el precio
ID del medidor — requerido para planes metered
Nombre del plan
1 <= length <= 255Precio en dólares (no centavos). Requerido para planes licensed; omitir para planes metered (su precio vive en usage_unit_amount/usage_tiers)
double0 <= valueID del producto al que está asociado este plan
uuidDías de prueba gratis antes del primer cobro. Entero de 0 a 365; 0 significa sin prueba. Solo para planes recurrentes: enviarlo en un plan one_time devuelve 400
0 <= value <= 365Tipo de plan: recurrente o pago único
"one_time" | "recurring"Modelo de precio por uso — requerido para planes metered
"per_unit" | "tiered" | "volume"Escalones de precio — requeridos para tiered/volume; el último debe tener up_to = null
Tipo de uso: licensed (precio fijo) o metered (facturado por consumo del medidor)
"licensed" | "metered"Tarifa por unidad en dólares — requerida para per_unit
doubleResponse Body
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.venflow.app/v1/plans" \ -H "Content-Type: application/json" \ -d '{ "name": "Plan Básico", "price": 29.99, "frequency": "monthly", "description": "Acceso completo a todas las funciones" }'{
"active": true,
"apply_discount_to_additional_items": true,
"billing_cycles": 0,
"created": 0.1,
"description": "string",
"external_id": "string",
"frequency": "hourly",
"id": "string",
"is_taxes_included": true,
"livemode": true,
"meter_id": "string",
"name": "string",
"object": "plan",
"price": 0,
"product_id": "string",
"trial_days": 0,
"type": "recurring",
"updated": 0.1,
"usage_pricing_model": "per_unit",
"usage_tiers": [
{
"unit_amount": 0.1,
"up_to": 0
}
],
"usage_type": "licensed",
"usage_unit_amount": 0
}{
"code": "not_found",
"details": {},
"message": "string"
}{
"code": "not_found",
"details": {},
"message": "string"
}{
"code": "not_found",
"details": {},
"message": "string"
}{
"code": "not_found",
"details": {},
"message": "string"
}{
"code": "not_found",
"details": {},
"message": "string"
}