Pipeline de API: comprar un plan Pro para hasta 10 proyectos
Objetivo: comprar un plan Pro (mensual, anual o vitalicio) que hace Pro hasta 10 de tus proyectos, añadir y liberar proyectos, desactivar la renovación automática.
Pasos
1. Oferta y estado.
GET /v0/my/plan
→ {"active": false, "auto_renew": false, "projects": [], "slots": 10, "seats_total": 18, "seats_left": …,
"project_usd": "18.00",
"prices": [{"kind": "monthly", "usd": "81.00"}, {"kind": "yearly", "usd": "818.18"}, {"kind": "lifetime", "usd": "999.00"}]}
Los precios de arriba son los del 2026-10-15; léelos de esta llamada. lifetime es una oferta beta limitada (seats_left).
2. Precio con cupón (opcional). GET /v0/my/coupons/quote?coupon=<clip>&target=yearly → list_usd, discount_usd, charged_usd, enough. Pipeline de API: canjear un cupón
3. Comprar.
POST /v0/my/plan
{"kind": "monthly"} (optional "coupon": "<clip>")
→ {"active": true, "kind": "monthly", "until": "2026-11-15T10:00:00Z", "auto_renew": true, "projects": [], …,
"list_usd": 81.0, "discount_usd": 0.0, "charged_usd": 81.0}
Comprar otra vez con un plan mensual o anual activo añade su periodo tras el until actual (también sirve para pasar de mensual a anual o al revés). El vitalicio no tiene fin.
4. Añadir un proyecto. POST /v0/my/plan/projects/<project> → el proyecto, ahora Pro a través del plan.
5. Liberar un proyecto. DELETE /v0/my/plan/projects/<project> → el proyecto, ahora Free; sus campañas y oráculos se detienen.
6. Desactivar la renovación automática. DELETE /v0/my/plan → "auto_renew": false; el plan sigue hasta until.
Detrás
- Renovación en
untilcon el saldo, mientrasauto_renewesté activo. - Saldo insuficiente al renovar: el plan vence, las campañas y oráculos de sus proyectos se detienen y @CabiChatBot te avisa.
Reglas
kind:monthly,yearlyolifetime; si no, 400.- Saldo insuficiente → 400
insufficient funds: <price> USDT required for the <kind> plan; sin plazas → 400no founding seats left; ya tienes un vitalicio → 400a lifetime plan is already active. - Añadir: sin plan activo → 400
no active plan; 10 en uso → 400all plan slots are used. Liberar un proyecto que no está en el plan → 400project is not on a plan slot. - Con un hueco libre, se rechaza comprar Pro para un solo proyecto: usa el hueco. Pipeline de API: hacer Pro un proyecto
Superficie de la API
| Endpoint | Para qué | FE | IA / oráculo |
|---|---|---|---|
GET /v0/my/plan |
Oferta y estado | sí | sí |
POST /v0/my/plan |
Comprar o ampliar | sí | sí |
DELETE /v0/my/plan |
Desactivar la renovación automática | sí | sí |
POST /v0/my/plan/projects/{nonce} |
Usar un hueco | sí | sí |
DELETE /v0/my/plan/projects/{nonce} |
Liberar un hueco | sí | sí |
Índice: Pipelines de API — índice