Plans

/v1/plans — productos recurrentes que tú defines y vendes a tus clientes. Ver también el concepto Plan.

El objeto Plan

{
  "id": "plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  "code": "pro-mensual",
  "name": "Plan Pro",
  "price_monthly_cents": 5000000,
  "price_annual_cents": 50000000,
  "trial_days": 7,
  "description": "Acceso completo a todas las funciones",
  "active": true,
  "created_at": "2026-08-24T15:00:00Z"
}

Campo	Tipo	Descripción
`id`	string	Identificador único del plan
`code`	string	Código único y legible (ej. `pro-mensual`)
`name`	string	Nombre visible del plan
`price_monthly_cents`	integer	Precio del ciclo mensual, en centavos COP
`price_annual_cents`	integer \| null	Precio del ciclo anual, en centavos COP
`trial_days`	integer \| null	Días de prueba antes del primer cobro
`description`	string \| null	Descripción libre
`active`	boolean	Si el plan admite nuevas suscripciones
`created_at`	datetime	Fecha de creación (ISO-8601 UTC)

Crear un plan

POST /v1/plans

Request body

{
  "code": "pro-mensual",
  "name": "Plan Pro",
  "price_monthly_cents": 5000000,
  "price_annual_cents": 50000000,
  "trial_days": 7,
  "description": "Acceso completo a todas las funciones",
  "active": true
}

Campo	Tipo	Requerido	Descripción
`code`	string	Sí	Código único y legible
`name`	string	Sí	Nombre visible
`price_monthly_cents`	integer	Sí	Precio mensual en centavos COP
`price_annual_cents`	integer	No	Precio anual en centavos COP
`trial_days`	integer	No	Días de prueba
`description`	string	No	Descripción libre
`active`	boolean	No	Por defecto `true`

Response — `201 Created`

Devuelve el objeto Plan creado.

curl -X POST https://api.rekurra.dev/v1/plans \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{
    "code": "pro-mensual",
    "name": "Plan Pro",
    "price_monthly_cents": 5000000,
    "trial_days": 7
  }'

const res = await fetch("https://api.rekurra.dev/v1/plans", {
  method: "POST",
  headers: {
    Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({
    code: "pro-mensual",
    name: "Plan Pro",
    price_monthly_cents: 5000000,
    trial_days: 7,
  }),
});
const plan = await res.json();

import requests
 
res = requests.post(
    "https://api.rekurra.dev/v1/plans",
    headers={
        "Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
        "Content-Type": "application/json",
    },
    json={
        "code": "pro-mensual",
        "name": "Plan Pro",
        "price_monthly_cents": 5000000,
        "trial_days": 7,
    },
)
plan = res.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
String body = """
    {
      "code": "pro-mensual",
      "name": "Plan Pro",
      "price_monthly_cents": 5000000,
      "trial_days": 7
    }
    """;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/plans"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .header("Content-Type", "application/json")
    .POST(HttpRequest.BodyPublishers.ofString(body))
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
using System.Text;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var json = """
    {
      "code": "pro-mensual",
      "name": "Plan Pro",
      "price_monthly_cents": 5000000,
      "trial_days": 7
    }
    """;
var content = new StringContent(json, Encoding.UTF8, "application/json");
 
var response = await http.PostAsync("https://api.rekurra.dev/v1/plans", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Errores posibles

Status	`error.type`	Causa
`400`	`invalid_request`	Falta `code`, `name` o `price_monthly_cents`, o `code` con formato inválido
`401`	`authentication_error`	API key inválida o ausente
`409`	`invalid_request`	Ya existe un plan con ese `code`

Listar planes

GET /v1/plans

Soporta paginación estándar: ?limit= (default 25, máx 100) y ?starting_after=<id>.

curl "https://api.rekurra.dev/v1/plans?limit=25" \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

const res = await fetch("https://api.rekurra.dev/v1/plans?limit=25", {
  headers: { Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" },
});
const { data, has_more, next_cursor } = await res.json();

import requests
 
res = requests.get(
    "https://api.rekurra.dev/v1/plans",
    params={"limit": 25},
    headers={"Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"},
)
body = res.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/plans?limit=25"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .GET()
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var response = await http.GetAsync("https://api.rekurra.dev/v1/plans?limit=25");
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response — `200 OK`

{ "data": [ /* Plan[] */ ], "has_more": false, "next_cursor": null }

Obtener un plan

GET /v1/plans/{id}

curl https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2 \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

const res = await fetch(
  "https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  { headers: { Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" } }
);
const plan = await res.json();

import requests
 
res = requests.get(
    "https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
    headers={"Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"},
)
plan = res.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .GET()
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var response = await http.GetAsync("https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2");
Console.WriteLine(await response.Content.ReadAsStringAsync());

Errores posibles

Status	`error.type`	Causa
`404`	`invalid_request`	El plan no existe o no pertenece a tu cuenta

Actualizar un plan

PATCH /v1/plans/{id}

Acepta cualquier subconjunto de los campos de creación.

curl -X PATCH https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2 \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" \
  -H "Content-Type: application/json" \
  -d '{ "name": "Plan Pro (nuevo nombre)" }'

const res = await fetch(
  "https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  {
    method: "PATCH",
    headers: {
      Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
      "Content-Type": "application/json",
    },
    body: JSON.stringify({ name: "Plan Pro (nuevo nombre)" }),
  }
);
const plan = await res.json();

import requests
 
res = requests.patch(
    "https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
    headers={
        "Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX",
        "Content-Type": "application/json",
    },
    json={"name": "Plan Pro (nuevo nombre)"},
)
plan = res.json()

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
String body = """
    {
      "name": "Plan Pro (nuevo nombre)"
    }
    """;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .header("Content-Type", "application/json")
    .method("PATCH", HttpRequest.BodyPublishers.ofString(body))
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
using System.Text;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var json = """
    {
      "name": "Plan Pro (nuevo nombre)"
    }
    """;
var content = new StringContent(json, Encoding.UTF8, "application/json");
 
var response = await http.PatchAsync("https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2", content);
Console.WriteLine(await response.Content.ReadAsStringAsync());

Errores posibles

Status	`error.type`	Causa
`400`	`invalid_request`	Campo con formato inválido
`404`	`invalid_request`	El plan no existe

Desactivar un plan

DELETE /v1/plans/{id}

Desactivación suave: marca active: false. Las suscripciones existentes que usan este plan no se ven afectadas.

curl -X DELETE https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2 \
  -H "Authorization: Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"

await fetch(
  "https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
  {
    method: "DELETE",
    headers: { Authorization: "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX" },
  }
);

import requests
 
requests.delete(
    "https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2",
    headers={"Authorization": "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX"},
)

import java.net.URI;
import java.net.http.HttpClient;
import java.net.http.HttpRequest;
import java.net.http.HttpResponse;
 
HttpRequest request = HttpRequest.newBuilder()
    .uri(URI.create("https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2"))
    .header("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX")
    .DELETE()
    .build();
 
HttpResponse<String> response = HttpClient.newHttpClient()
    .send(request, HttpResponse.BodyHandlers.ofString());
System.out.println(response.body());

using System.Net.Http;
 
using var http = new HttpClient();
http.DefaultRequestHeaders.Add("Authorization", "Bearer rk_live_XXXXXXXXXXXXXXXXXXXXXXXX");
 
var response = await http.DeleteAsync("https://api.rekurra.dev/v1/plans/plan_01HZXK7QJ5M8Z9X2R3TVQ7A1B2");
Console.WriteLine(await response.Content.ReadAsStringAsync());

Response — `200 OK`

Devuelve el objeto Plan con active: false.

Webhooks Addons

Plans

El objeto Plan

Crear un plan

Request body

Response — 201 Created

Errores posibles

Listar planes

Response — 200 OK

Obtener un plan

Errores posibles

Actualizar un plan

Errores posibles

Desactivar un plan

Response — 200 OK

Response — `201 Created`

Response — `200 OK`

Response — `200 OK`