| parameter_missing | 400 | invalid_request_error | Falta un parámetro obligatorio (param dice cuál). |
| parameter_invalid | 400 | invalid_request_error | Un parámetro tiene un valor que no sirve. |
| parameter_unknown | 400 | invalid_request_error | Enviaste un parámetro que no existe en esa ruta. |
| invalid_json | 400 | invalid_request_error | El cuerpo no es JSON válido. |
| request_too_large | 413 | invalid_request_error | El cuerpo supera los 256 KB. |
| resource_missing | 404 | invalid_request_error | No existe ese id en este modo de esta cuenta. |
| url_invalid | 400 | invalid_request_error | La URL no es HTTPS o apunta a una red interna. |
| api_version_invalid | 400 | invalid_request_error | La cabecera Bucli-Version no es una versión vigente. |
| mode_mismatch | 400 | invalid_request_error | La cabecera Bucli-Mode contradice el modo de la llave. |
| api_key_missing | 401 | authentication_error | No enviaste la cabecera Authorization. |
| api_key_invalid | 401 | authentication_error | La llave no existe. |
| api_key_revoked | 401 | authentication_error | La llave fue revocada o regenerada. |
| authentication_required | 401 | authentication_error | La sesión del dashboard venció. |
| no_active_subscription | 402 | billing_error | La cuenta no tiene plan de Bucli. |
| subscription_read_only | 402 | billing_error | Tu plan de Bucli está en solo lectura: no se escribe. |
| module_not_active | 403 | permission_error | Tu plan no incluye la API. |
| feature_not_available | 403 | permission_error | Tu plan no incluye esto (los webhooks: Pro). |
| secret_key_required | 403 | permission_error | Una llave publicable (pk_) no puede hacer esto. |
| permission_denied | 403 | permission_error | Tu rol en el equipo no tiene ese permiso (dashboard). |
| account_forbidden | 403 | permission_error | No eres miembro de esa cuenta (dashboard). |
| support_read_only | 403 | permission_error | Sesión de soporte de Bucli de solo lectura. |
| route_not_found | 404 | invalid_request_error | La ruta no existe. |
| method_not_allowed | 405 | invalid_request_error | Esa ruta no acepta ese método. |
| resource_already_exists | 409 | invalid_request_error | Ya existe (un cliente con ese correo). |
| idempotency_key_in_use | 409 | idempotency_error | Otra petición con esa Idempotency-Key sigue en curso. |
| idempotency_key_reused | 409 | idempotency_error | Esa Idempotency-Key ya se usó con otro cuerpo. |
| webhook_secret_unavailable_on_replay | 409 | invalid_request_error | La respuesta repetida traía un secreto de firma, que se muestra una sola vez: regenéralo con roll_secret. error.object_id trae el id del endpoint (we_…) y error.object_type, webhook_endpoint. |
| url_unavailable_on_replay | 409 | invalid_request_error | La respuesta repetida traía una URL con token. error.object_id trae el id de la sesión y error.object_type su tipo: una de checkout (cs_…) se consulta con GET /checkout_sessions/{id}, que trae su url; una del portal (bps_…) no la vuelve a mostrar: crea otra con una clave nueva. |
| reauth_failed | 403 | permission_error | Dashboard: falta o no es válida la confirmación de identidad. |
| code_required | 403 | permission_error | Dashboard: pide el código por correo y envíalo en code. |
| reauth_locked | 429 | rate_limit_error | Dashboard: demasiados intentos de confirmar la identidad. |
| customer_has_active_subscriptions | 422 | invalid_request_error | El cliente tiene suscripciones en curso. |
| customer_has_open_charges | 422 | invalid_request_error | El cliente tiene cobros abiertos (una factura por cobrar o una oferta de plazo fijo). |
| product_has_prices | 422 | invalid_request_error | El producto tiene precios: archívalo. |
| price_in_use | 400 | invalid_request_error | El precio ya se usa: crea otro y archiva este. |
| product_inactive | 422 | invalid_request_error | El producto está archivado. |
| active_subscriptions_limit_reached | 402 | billing_error | Llegaste a las suscripciones activas de tu plan. |
| price_inactive | 400 | invalid_request_error | El precio está archivado. |
| customer_deleted | 400 | invalid_request_error | El cliente fue eliminado. |
| payment_method_unavailable | 400 | invalid_request_error | El método de pago no se puede cobrar. |
| payment_method_rejected | 402 | billing_error | Wompi rechazó el método de pago. |
| invalid_metadata | 400 | invalid_request_error | metadata no cumple los límites. |
| subscription_not_updatable | 409 | invalid_request_error | La suscripción ya terminó o no admite ese cambio. |
| invalid_cancellation_reason | 400 | invalid_request_error | Motivo de cancelación desconocido. |
| invoice_not_open | 409 | invalid_request_error | Solo se cobra una factura abierta. |
| coupon_terms_frozen | 400 | invalid_request_error | El cupón ya se aplicó: sus términos no cambian. |
| coupon_not_redeemable | 400 | invalid_request_error | El cupón no se puede aplicar (vencido, sin usos…). |
| discount_missing | 404 | invalid_request_error | La suscripción no tiene un descuento vigente. |
| payment_not_refundable | 400 | invalid_request_error | Ese pago no tiene nada que reembolsar. |
| payment_not_voidable | 400 | invalid_request_error | Solo se anula un cobro con tarjeta de hoy, completo. |
| refund_in_progress | 409 | invalid_request_error | Ya hay un reembolso de ese pago esperando a Wompi. |
| subscription_not_pausable | 409 | invalid_request_error | Solo se pausa una activa o en prueba al día. |
| subscription_not_paused | 409 | invalid_request_error | No está pausada ni tiene una pausa pedida. |
| subscription_not_extendable | 409 | invalid_request_error | Solo se extiende una activa al día. |
| trial_not_running | 409 | invalid_request_error | La suscripción no está en prueba. |
| plan_price_required | 400 | invalid_request_error | Ese precio no es de un plan (es de la prueba o de un adicional). |
| fixed_term_offer_open | 409 | invalid_request_error | Ese cliente ya tiene una oferta esperando el pago. |
| fixed_term_offer_not_open | 409 | invalid_request_error | Esa oferta ya no espera el pago. |
| fixed_term_unavailable | 409 | invalid_request_error | Faltan tus llaves de Wompi para crear el link. |
| fixed_term_not_changeable | 409 | invalid_request_error | Un plan por tiempo fijo no cambia de plan. |
| manual_payment_reference_used | 409 | invalid_request_error | Esa referencia ya se usó en otro pago manual. |
| exchange_rate_unavailable | 503 | api_error | No hay una tasa de cambio vigente: inténtalo más tarde. |
| invoice_payment_in_progress | 409 | invalid_request_error | Ya hay un cobro de esa factura en curso. |
| invoice_charge_blocked | 409 | invalid_request_error | Un freno de cobros (pausa de Bucli, tus cobros pausados o el tope diario) detiene el cobro; message dice cuál. La factura espera y se cobra sola cuando se libere. |
| invoice_not_voidable | 409 | invalid_request_error | Solo se anula una factura en borrador o abierta. |
| price_not_recurring | 400 | invalid_request_error | Ese precio es de pago único: no va en una suscripción. |
| price_not_one_time | 400 | invalid_request_error | Una factura única solo lleva precios de pago único. |
| price_interval_mismatch | 400 | invalid_request_error | Los ítems de una suscripción comparten intervalo. |
| price_currency_mismatch | 400 | invalid_request_error | Lo que se cobra junto va en una moneda: no se mezclan pesos y dólares. |
| subscription_item_duplicate_price | 400 | invalid_request_error | Ese precio ya es un ítem: cambia su cantidad. |
| subscription_item_last | 400 | invalid_request_error | El último ítem no se quita: cancela la suscripción. |
| subscription_items_invalid | 400 | invalid_request_error | Una suscripción tiene de 1 a 20 ítems. |
| subscription_has_multiple_items | 400 | invalid_request_error | Con varios ítems, cambia cada ítem. |
| quantity_invalid | 400 | invalid_request_error | La cantidad va de 1 a 10.000. |
| proration_unavailable | 400 | invalid_request_error | proration_behavior es none o create_prorations. |
| quote_changed | 409 | invalid_request_error | El cambio ya no cuesta lo que dijo la vista previa. |
| payment_method_required | 409 | invalid_request_error | Es la única tarjeta de una suscripción que se renueva. |
| payment_method_is_default | 409 | invalid_request_error | Esa tarjeta es la predeterminada. |
| subscription_update_in_progress | 409 | invalid_request_error | La suscripción tiene un cambio esperando su cobro. |
| subscription_change_too_complex | 400 | invalid_request_error | Un cambio que baja el valor y agrega precios nuevos va en dos pasos. |
| billing_cycle_anchor_invalid | 400 | invalid_request_error | El ancla no es futura o pasa de un ciclo. |
| trial_end_invalid | 400 | invalid_request_error | El fin de la prueba no es futuro o pasa de 730 días. |
| invoice_lines_invalid | 400 | invalid_request_error | De 1 a 20 líneas, o amount con description. |
| invoice_amount_too_small | 400 | invalid_request_error | Wompi no cobra un monto tan pequeño. |
| customer_payment_method_missing | 400 | invalid_request_error | El cliente no tiene tarjeta para cobrar. |
| wompi_payment_source_missing | 404 | invalid_request_error | Wompi no tiene esa fuente en tu cuenta. |
| wompi_payment_source_unavailable | 400 | invalid_request_error | La fuente no está AVAILABLE en Wompi. |
| wompi_payment_source_unsupported | 400 | invalid_request_error | Solo se importan tarjetas (CARD). |
| payment_method_attached_elsewhere | 409 | invalid_request_error | Esa fuente ya es de otro cliente. |
| wompi_credentials_missing | 409 | invalid_request_error | Conecta tus llaves de Wompi de este modo. |
| wompi_credentials_invalid | 400 | invalid_request_error | Wompi rechazó tus llaves: revísalas y verifícalas. |
| wompi_unavailable | 503 | api_error | Wompi no respondió: reintenta en unos minutos. |
| checkout_session_not_expirable | 409 | invalid_request_error | La sesión ya no está abierta o espera un cobro. |
| webhook_endpoint_limit_reached | 422 | invalid_request_error | Llegaste al máximo de endpoints del modo. |
| feature_in_use | 422 | invalid_request_error | Un producto, un ajuste o un medidor usa ese derecho. |
| feature_unknown | 400 | invalid_request_error | Esa clave no existe en tu vocabulario (/features). |
| feature_type_mismatch | 400 | invalid_request_error | Un módulo va en features y un límite en limits. |
| limit_invalid | 400 | invalid_request_error | Un límite es un entero ≥ 0, o -1 para ilimitado. |
| limit_unlimited_not_allowed | 400 | invalid_request_error | Ese límite nunca es ilimitado (-1). |
| product_rules_invalid | 400 | invalid_request_error | Las reglas o los derechos del producto no son válidos. |
| trial_product_exists | 409 | invalid_request_error | Ya tienes un producto de prueba activo en este modo. |
| trial_product_locked | 422 | invalid_request_error | Un producto con precios no cambia is_trial. |
| trial_price_invalid | 400 | invalid_request_error | El precio de prueba es recurrente, de $0 y con días. |
| product_not_offered | 400 | invalid_request_error | Ese producto es interno: no se vende. |
| product_coming_soon | 400 | invalid_request_error | Ese producto todavía no está a la venta. |
| quantity_not_supported | 400 | invalid_request_error | Ese producto no se vende por unidades. |
| addon_requires_feature | 400 | invalid_request_error | El adicional exige un módulo que la suscripción no tiene. |
| addon_requires_plan | 400 | invalid_request_error | El adicional solo se vende sobre ciertos planes. |
| addon_included | 400 | invalid_request_error | El plan ya incluye lo que da el adicional. |
| addon_not_allowed_during_trial | 400 | invalid_request_error | El adicional no se vende durante la prueba. |
| trial_product_misused | 400 | invalid_request_error | El producto de prueba va solo, en una suscripción nueva en prueba. |
| trial_already_used | 409 | invalid_request_error | Ya se dio una prueba con esa trial_key. |
| meter_feature_missing | 400 | invalid_request_error | Crea antes el límite metered con la misma clave. |
| meter_inactive | 409 | invalid_request_error | Ese medidor está apagado. |
| quota_exhausted | 402 | billing_error | Se acabó el cupo y no hay bolsas con saldo (el detalle viene en el error). |
| entitlement_access_denied | 402 | billing_error | El cliente no tiene acceso completo: no consume. |
| usage_report_invalid | 400 | invalid_request_error | occurred_at es futuro o demasiado viejo. |
| usage_idempotency_key_reused | 409 | invalid_request_error | Esa llave ya se usó con otra cantidad. |
| grant_offer_price_invalid | 400 | invalid_request_error | Una oferta se cobra con un precio one_time activo. |
| grant_offer_unavailable | 400 | invalid_request_error | Esa oferta de bolsa está archivada. |
| grant_offer_requires_feature | 400 | invalid_request_error | El cliente no tiene los módulos que exige la bolsa. |
| grant_not_withdrawable | 409 | invalid_request_error | Esa bolsa ya no está vigente. |
| rate_limited | 429 | rate_limit_error | Demasiadas peticiones: espera Retry-After segundos. |
| internal_error | 500 | api_error | Falló algo de nuestro lado: reintenta con la misma Idempotency-Key. |
| engine_unavailable | 503 | api_error | El motor de cobros no responde: reintenta en unos minutos. |