Saltar al contenido principal
POST
Crear pedido
string
predeterminado:"purchase"
Para qué es el pedido. Valores posibles: purchase, renew, upgrade.
string
requerido
El slug del plan que se compra, renueva o al que se actualiza.
integer
requerido
Cuántos meses comprar: 1, 3 o 12. El plan Economy solo acepta 1. Cualquier otro valor devuelve INVALID_MONTHS. Un pedido de 3 meses tiene un 5% de descuento y un pedido de 12 meses un 15% de descuento sobre el precio mensual; price y discount ya lo incluyen.
string
Un código de cupón de descuento opcional.
El pedido necesita datos de facturación completos: comprueba complete en Obtener los datos de facturación.
Un pedido renew requiere que el plan indicado coincida con el plan actual de la cuenta; un pedido upgrade requiere que sea estrictamente superior. Usa type: "purchase" cuando todavía no exista un plan activo de ese tipo.

Respuesta

object

Respuestas de error

string
El código de error que indica el motivo del fallo. Valores posibles:
  • AUTH_TOKEN_MISSING, API_KEY_INVALID, SESSION_REVOKED: Falta la cabecera Authorization, la clave de API no es válida o la sesión del panel fue revocada (401).
  • API_KEY_IP_DENIED, API_KEY_SCOPE_DENIED: La clave de API se usa desde una IP fuera de su lista de permitidas, o no tiene el scope que requiere la ruta (403).
  • USER_NOT_FOUND: No se encontró el usuario autenticado.
  • INVALID_PAYLOAD: El cuerpo de la petición no superó la validación.
  • BILLING_DETAILS_INCOMPLETE: Los datos de facturación no están completos (nombre, dirección y, en Brasil, CPF/CNPJ). Guárdalos con Actualizar los datos de facturación y vuelve a intentarlo.
  • MISSING_PLAN_OR_MONTHS: Falta plan o months.
  • INVALID_MONTHS: months no es 1, 3 o 12, o no es 1 para el plan Economy.
  • INVALID_PLAN: El slug del plan no existe.
  • NOT_AN_UPGRADE: Para type: "upgrade", el plan indicado no es superior al actual.
  • PLAN_MISMATCH_FOR_RENEWAL: Para type: "renew", el plan indicado no coincide con el actual.
  • PENDING_ORDER_LIMIT_REACHED: Ya hay demasiados pedidos pendientes de pago abiertos.
  • INTERNAL_SERVER_ERROR: Se produjo un error inesperado en el servidor.
Última modificación el 28 de octubre de 2026