{
  "openapi": "3.1.0",
  "info": {
    "title": "API de Bucli",
    "version": "2026-11-01",
    "description": "Cobros recurrentes sobre Wompi: clientes, planes, suscripciones, facturas, pagos, eventos y webhooks.\n\n- Autenticaci\u00f3n: `Authorization: Bearer sk_test_\u2026` (pruebas, sandbox de Wompi) o `sk_live_\u2026` (producci\u00f3n). La llave decide el modo. Las `pk_` solo crean checkouts desde el navegador.\n- Ids con prefijo (`cus_`, `prod_`, `price_`, `sub_`, `in_`, `py_`, `pm_`, `evt_`, `we_`) y `object` en cada respuesta.\n- `Idempotency-Key` en los POST: la misma clave repite la respuesta guardada (24 h, con `Idempotent-Replayed: true`); con otro cuerpo responde `409 idempotency_key_reused`. No se guardan los errores 5xx, 402, 404 ni 409 (reintentar con la misma clave vuelve a ejecutar la petici\u00f3n). La respuesta guardada no conserva secretos, URL con token ni el documento o el tel\u00e9fono de tus clientes: esos campos vienen ocultos, y si la respuesta tra\u00eda un secreto de firma o la URL de una sesi\u00f3n, el replay responde `409 webhook_secret_unavailable_on_replay` o `409 url_unavailable_on_replay`, con el id del objeto en `error.object_id` (y su tipo en `error.object_type`).\n- Listas: `limit` (1 a 100, por defecto 10), `starting_after`, `ending_before` \u2192 `{object: \"list\", data, has_more, url}`.\n- `expand[]=customer` trae el objeto relacionado completo (en listas, `expand[]=data.customer`): hasta 4 caminos por petici\u00f3n, de hasta 4 niveles.\n- El cuerpo de una petici\u00f3n admite hasta 256 KB (`413 request_too_large`).\n- Montos en pesos enteros (`89900` = $89.900); fechas ISO 8601 en UTC. `created` y `updated` (\u00faltimo cambio) van en el mismo formato: usa `updated` para no pisar tu copia local con un dato m\u00e1s viejo.\n- Versi\u00f3n: `Bucli-Version` (vigente: `2026-11-01`); tu cuenta queda fijada a la de su creaci\u00f3n.\n- Cada respuesta trae `Request-Id`; cada error, `{error: {type, code, message, param, doc_url, request_id}}`.\n- L\u00edmite por llave: 100 peticiones por segundo en producci\u00f3n y 25 en pruebas, con cabeceras `RateLimit-*`; adem\u00e1s, todas las llaves de tu cuenta juntas: 200 por segundo en producci\u00f3n y 50 en pruebas. Una llave `pk_` cuenta por llave y direcci\u00f3n IP (10 por segundo). Una lista con `expand[]` cuesta `1 + limit \u00d7 caminos \u00f7 20` peticiones.\n- Eventos y webhooks: el orden de entrega no est\u00e1 garantizado. Cada evento trae `sequence` (crece con cada evento): comp\u00e1ralo, o vuelve a consultar el objeto, antes de actuar.\n- Llaves de producci\u00f3n: en el dashboard las crea, renombra, regenera o revoca solo el propietario o un administrador (`developers.api_keys.manage_live`), confirmando su identidad; el rol Desarrollador gestiona las de pruebas. Cada llave de producci\u00f3n nueva o regenerada se avisa por correo al propietario, y las llaves que cre\u00f3 un miembro se revocan cuando sale del equipo."
  },
  "servers": [
    {
      "url": "https://api.bucli.co/v1"
    }
  ],
  "security": [
    {
      "SecretKey": []
    }
  ],
  "tags": [
    {
      "name": "customers",
      "description": "Qui\u00e9n paga tus suscripciones."
    },
    {
      "name": "products",
      "description": "Lo que vendes."
    },
    {
      "name": "prices",
      "description": "Cu\u00e1nto y cada cu\u00e1nto."
    },
    {
      "name": "subscriptions",
      "description": "El contrato recurrente."
    },
    {
      "name": "subscription_items",
      "description": "Plan base, puestos y adicionales."
    },
    {
      "name": "payment_methods",
      "description": "Tarjetas y Nequi guardados en Wompi."
    },
    {
      "name": "invoices",
      "description": "Lo que cuesta cada periodo: el objeto `invoice`, que en el panel se llama \u00abcobro\u00bb. No es la factura electr\u00f3nica de la DIAN: esa la emite tu facturador (o la integraci\u00f3n con Klopi, `fiscal_document`)."
    },
    {
      "name": "payments",
      "description": "Cada intento de cobro en Wompi."
    },
    {
      "name": "coupons",
      "description": "Descuentos para tus suscripciones."
    },
    {
      "name": "refunds",
      "description": "El dinero que devuelves."
    },
    {
      "name": "fixed_term_offers",
      "description": "Un plan pagado una vez, por d\u00edas."
    },
    {
      "name": "events",
      "description": "Cada cambio, consultable 30 d\u00edas."
    },
    {
      "name": "webhook_endpoints",
      "description": "D\u00f3nde te avisamos de los eventos."
    },
    {
      "name": "account",
      "description": "Tu comercio en la API."
    },
    {
      "name": "checkout_sessions",
      "description": "La p\u00e1gina de pago hospedada."
    },
    {
      "name": "payment_links",
      "description": "Vender un plan sin c\u00f3digo."
    },
    {
      "name": "portal_sessions",
      "description": "Donde tu cliente administra lo suyo."
    },
    {
      "name": "features",
      "description": "Tu vocabulario de m\u00f3dulos y l\u00edmites."
    },
    {
      "name": "entitlements",
      "description": "Qu\u00e9 tiene cada cliente y su acceso."
    },
    {
      "name": "meters",
      "description": "Cupos por ventana."
    },
    {
      "name": "usage",
      "description": "Reservar, reportar y devolver unidades."
    },
    {
      "name": "grant_offers",
      "description": "Paquetes de unidades que vendes."
    },
    {
      "name": "grants",
      "description": "Unidades prepagadas de cada cliente."
    }
  ],
  "paths": {
    "/customers": {
      "post": {
        "operationId": "customers-create",
        "summary": "Crear un cliente",
        "description": "El correo es \u00fanico por cuenta y modo: uno repetido responde `409 resource_already_exists`.",
        "tags": [
          "customers"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/customer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.customers.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_already_exists"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "Correo del cliente."
                  },
                  "external_id": {
                    "type": "string",
                    "description": "Tu id del cliente (hasta 120): \u00fanico por modo. Con \u00e9l, varios clientes pueden compartir correo (un cliente por empresa); un checkout p\u00fablico nunca encuentra un cliente con `external_id` por el correo."
                  },
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "phone": {
                    "type": "string",
                    "description": "Celular."
                  },
                  "legal_id_type": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "CC",
                      "CE",
                      "NIT",
                      "PP",
                      "TI",
                      "PPT"
                    ],
                    "description": "Tipo de documento."
                  },
                  "legal_id": {
                    "type": "string",
                    "description": "N\u00famero de documento."
                  },
                  "fiscal": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Sus datos para la factura electr\u00f3nica, ENTEROS (reemplazan los anteriores; `null` los quita): `party_type`, `document_type`, `document_number` (un NIT puede venir `900123456-8`), `verification_digit` (si falta, se calcula; si no cuadra, 400), `business_name` (empresa) o `first_name`/`last_name` (persona), `email` (adonde llega la factura), `address` y `city_code` (DANE, obligatorios en Colombia), `country_code` (por defecto `CO`; fuera de Colombia, `city_name`), `tax_regime`, `is_vat_responsible`, `is_great_contributor`, `is_self_withholder` y `rut_responsibilities` (solo con NIT colombiano), o `{\"final_consumer\": true}` si el comercio lo permite. Llena `legal_id_type`/`legal_id` si no los env\u00edas. Son los datos ya llenos que el cliente confirma o corrige en el checkout y el portal: lo que corrija ah\u00ed (o el comercio en el panel) ya no lo reemplaza tu `fiscal`, y la respuesta trae los datos vigentes con su `source`."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "email"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "customers-list",
        "summary": "Listar clientes",
        "description": "Del m\u00e1s reciente al m\u00e1s antiguo. Los eliminados no aparecen.",
        "tags": [
          "customers"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "email",
            "in": "query",
            "required": false,
            "description": "Correo exacto (puede haber varios con `external_id`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "external_id",
            "in": "query",
            "required": false,
            "description": "Tu id exacto.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "metadata[<clave>]",
            "in": "query",
            "required": false,
            "description": "Solo los que tienen ese par en su metadata.",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.customers.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited"
        ]
      }
    },
    "/customers/{id}": {
      "get": {
        "operationId": "customers-retrieve",
        "summary": "Consultar un cliente",
        "description": "Un cliente eliminado responde `{id, object, deleted: true}`.",
        "tags": [
          "customers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/customer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.customers.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "customers-update",
        "summary": "Actualizar un cliente",
        "description": "Cambia solo lo que env\u00edas. Emite `customer.updated` con `previous_attributes`.",
        "tags": [
          "customers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/customer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.customers.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "resource_already_exists"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "email": {
                    "type": "string",
                    "description": "Correo del cliente."
                  },
                  "external_id": {
                    "type": "string",
                    "description": "Tu id del cliente (hasta 120): \u00fanico por modo. Con \u00e9l, varios clientes pueden compartir correo (un cliente por empresa); un checkout p\u00fablico nunca encuentra un cliente con `external_id` por el correo."
                  },
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "phone": {
                    "type": "string",
                    "description": "Celular."
                  },
                  "legal_id_type": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "CC",
                      "CE",
                      "NIT",
                      "PP",
                      "TI",
                      "PPT"
                    ],
                    "description": "Tipo de documento."
                  },
                  "legal_id": {
                    "type": "string",
                    "description": "N\u00famero de documento."
                  },
                  "fiscal": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Sus datos para la factura electr\u00f3nica, ENTEROS (reemplazan los anteriores; `null` los quita): `party_type`, `document_type`, `document_number` (un NIT puede venir `900123456-8`), `verification_digit` (si falta, se calcula; si no cuadra, 400), `business_name` (empresa) o `first_name`/`last_name` (persona), `email` (adonde llega la factura), `address` y `city_code` (DANE, obligatorios en Colombia), `country_code` (por defecto `CO`; fuera de Colombia, `city_name`), `tax_regime`, `is_vat_responsible`, `is_great_contributor`, `is_self_withholder` y `rut_responsibilities` (solo con NIT colombiano), o `{\"final_consumer\": true}` si el comercio lo permite. Llena `legal_id_type`/`legal_id` si no los env\u00edas. Son los datos ya llenos que el cliente confirma o corrige en el checkout y el portal: lo que corrija ah\u00ed (o el comercio en el panel) ya no lo reemplaza tu `fiscal`, y la respuesta trae los datos vigentes con su `source`."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "customers-delete",
        "summary": "Eliminar un cliente",
        "description": "Lo saca de las listas y libera su correo; sus facturas y pagos se conservan. Con suscripciones en curso (o incompletas) responde `422 customer_has_active_subscriptions`; con un cobro abierto (factura por cobrar u oferta de plazo fijo sin pagar) responde `422 customer_has_open_charges`.",
        "tags": [
          "customers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deleted"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.customers.destroy",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "customer_has_active_subscriptions",
          "customer_has_open_charges"
        ]
      }
    },
    "/customers/{id}/payment_methods": {
      "get": {
        "operationId": "customers-payment-methods",
        "summary": "Listar los m\u00e9todos de pago de un cliente",
        "description": "Las tarjetas y cuentas Nequi que guard\u00f3 en el checkout o el portal (la API no las crea: PCI).",
        "tags": [
          "payment_methods"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payment_methods.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/products": {
      "post": {
        "operationId": "products-create",
        "summary": "Crear un producto",
        "description": "Lo que vendes (\u00abPlan Gold\u00bb); el monto va en sus precios. Emite `product.created`.",
        "tags": [
          "products"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.products.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_already_exists",
          "feature_unknown",
          "feature_type_mismatch",
          "limit_invalid",
          "limit_unlimited_not_allowed",
          "product_rules_invalid",
          "trial_product_exists"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "description": {
                    "type": "string",
                    "description": "Descripci\u00f3n."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Activo (por defecto `true`)."
                  },
                  "key": {
                    "type": "string",
                    "description": "Tu c\u00f3digo del producto, \u00fanico por modo."
                  },
                  "entitlements": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "`{features: [claves], limits: {clave: n\u00famero}}` de tu vocabulario; `-1` = ilimitado. Se reemplaza entero."
                  },
                  "is_addon": {
                    "type": "boolean",
                    "description": "Es un adicional."
                  },
                  "is_trial": {
                    "type": "boolean",
                    "description": "Es tu producto de prueba (uno activo por modo); no cambia si ya tiene precios."
                  },
                  "supports_quantity": {
                    "type": "boolean",
                    "description": "Se vende por unidades (por defecto `true`)."
                  },
                  "requires_features": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Adicional: m\u00f3dulos que la suscripci\u00f3n ya debe tener."
                  },
                  "allowed_base_products": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Adicional: ids de los planes sobre los que se vende (vac\u00edo = todos)."
                  },
                  "skip_if_included": {
                    "type": "boolean",
                    "description": "Adicional: no se vende si el plan ya da todos sus m\u00f3dulos."
                  },
                  "allowed_during_trial": {
                    "type": "boolean",
                    "description": "Adicional: se vende durante la prueba (por defecto `false`)."
                  },
                  "prorate_limits_on_add": {
                    "type": "boolean",
                    "description": "Prorratear sus cupos medidos al agregarlo a mitad de ventana."
                  },
                  "meter_window": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "calendar_month",
                      "billing_period",
                      "subscription_lifetime"
                    ],
                    "description": "Mientras sea el plan base de la suscripci\u00f3n, los medidores cuentan en esta ventana y no en la suya (`subscription_lifetime`: la prueba o el plazo fijo de punta a punta). Vac\u00edo = la del medidor."
                  },
                  "availability": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "public",
                      "coming_soon",
                      "internal"
                    ],
                    "description": "Disponibilidad."
                  },
                  "availability_note": {
                    "type": "string",
                    "description": "Nota de disponibilidad."
                  },
                  "marketing_features": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Textos de la vitrina (hasta 30)."
                  },
                  "position": {
                    "type": "integer",
                    "description": "Orden en la vitrina."
                  },
                  "featured": {
                    "type": "boolean",
                    "description": "Destacado."
                  },
                  "visible_in_pricing": {
                    "type": "boolean",
                    "description": "Visible en la vitrina (por defecto `true`)."
                  },
                  "placement": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "main",
                      "secondary"
                    ],
                    "description": "En la vitrina: `main` (por defecto), una tarjeta entre los planes principales; `secondary`, una l\u00ednea bajo ellos."
                  },
                  "icon": {
                    "type": "string",
                    "description": "\u00cdcono."
                  },
                  "group": {
                    "type": "string",
                    "description": "Grupo libre (`module`, `seats`, `units`\u2026)."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "name"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "products-list",
        "summary": "Listar productos",
        "description": "Del m\u00e1s reciente al m\u00e1s antiguo.",
        "tags": [
          "products"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Solo activos o archivados.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "key",
            "in": "query",
            "required": false,
            "description": "Tu c\u00f3digo exacto.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "availability",
            "in": "query",
            "required": false,
            "description": "Disponibilidad.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "public",
                "coming_soon",
                "internal"
              ]
            }
          },
          {
            "name": "is_addon",
            "in": "query",
            "required": false,
            "description": "Solo adicionales o solo planes.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "is_trial",
            "in": "query",
            "required": false,
            "description": "Solo el producto de prueba.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "group",
            "in": "query",
            "required": false,
            "description": "Grupo exacto.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "visible_in_pricing",
            "in": "query",
            "required": false,
            "description": "Solo los visibles en la vitrina.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "placement",
            "in": "query",
            "required": false,
            "description": "Solo los de esa ubicaci\u00f3n en la vitrina.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "main",
                "secondary"
              ]
            }
          },
          {
            "name": "kind",
            "in": "query",
            "required": false,
            "description": "Solo los de ese tipo (`kind`).",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "plan",
                "addon",
                "one_time",
                "trial"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.products.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/products/{id}": {
      "get": {
        "operationId": "products-retrieve",
        "summary": "Consultar un producto",
        "description": "",
        "tags": [
          "products"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.products.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "products-update",
        "summary": "Actualizar o archivar un producto",
        "description": "`active: false` lo archiva. Cambiar lo que da (`entitlements`, `supports_quantity`\u2026) recalcula los derechos de todas sus suscripciones y emite `entitlements.updated` a cada una que cambie. Todo cambio emite `product.updated` con `previous_attributes`.",
        "tags": [
          "products"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/product"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.products.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "resource_already_exists",
          "feature_unknown",
          "feature_type_mismatch",
          "limit_invalid",
          "limit_unlimited_not_allowed",
          "product_rules_invalid",
          "trial_product_exists",
          "trial_product_locked"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "description": {
                    "type": "string",
                    "description": "Descripci\u00f3n."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Activo (por defecto `true`)."
                  },
                  "key": {
                    "type": "string",
                    "description": "Tu c\u00f3digo del producto, \u00fanico por modo."
                  },
                  "entitlements": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "`{features: [claves], limits: {clave: n\u00famero}}` de tu vocabulario; `-1` = ilimitado. Se reemplaza entero."
                  },
                  "is_addon": {
                    "type": "boolean",
                    "description": "Es un adicional."
                  },
                  "is_trial": {
                    "type": "boolean",
                    "description": "Es tu producto de prueba (uno activo por modo); no cambia si ya tiene precios."
                  },
                  "supports_quantity": {
                    "type": "boolean",
                    "description": "Se vende por unidades (por defecto `true`)."
                  },
                  "requires_features": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Adicional: m\u00f3dulos que la suscripci\u00f3n ya debe tener."
                  },
                  "allowed_base_products": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Adicional: ids de los planes sobre los que se vende (vac\u00edo = todos)."
                  },
                  "skip_if_included": {
                    "type": "boolean",
                    "description": "Adicional: no se vende si el plan ya da todos sus m\u00f3dulos."
                  },
                  "allowed_during_trial": {
                    "type": "boolean",
                    "description": "Adicional: se vende durante la prueba (por defecto `false`)."
                  },
                  "prorate_limits_on_add": {
                    "type": "boolean",
                    "description": "Prorratear sus cupos medidos al agregarlo a mitad de ventana."
                  },
                  "meter_window": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "calendar_month",
                      "billing_period",
                      "subscription_lifetime"
                    ],
                    "description": "Mientras sea el plan base de la suscripci\u00f3n, los medidores cuentan en esta ventana y no en la suya (`subscription_lifetime`: la prueba o el plazo fijo de punta a punta). Vac\u00edo = la del medidor."
                  },
                  "availability": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "public",
                      "coming_soon",
                      "internal"
                    ],
                    "description": "Disponibilidad."
                  },
                  "availability_note": {
                    "type": "string",
                    "description": "Nota de disponibilidad."
                  },
                  "marketing_features": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Textos de la vitrina (hasta 30)."
                  },
                  "position": {
                    "type": "integer",
                    "description": "Orden en la vitrina."
                  },
                  "featured": {
                    "type": "boolean",
                    "description": "Destacado."
                  },
                  "visible_in_pricing": {
                    "type": "boolean",
                    "description": "Visible en la vitrina (por defecto `true`)."
                  },
                  "placement": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "main",
                      "secondary"
                    ],
                    "description": "En la vitrina: `main` (por defecto), una tarjeta entre los planes principales; `secondary`, una l\u00ednea bajo ellos."
                  },
                  "icon": {
                    "type": "string",
                    "description": "\u00cdcono."
                  },
                  "group": {
                    "type": "string",
                    "description": "Grupo libre (`module`, `seats`, `units`\u2026)."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "products-delete",
        "summary": "Eliminar un producto",
        "description": "Solo uno sin precios; si tiene, arch\u00edvalo (`422 product_has_prices`).",
        "tags": [
          "products"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deleted"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.products.destroy",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "product_has_prices"
        ]
      }
    },
    "/prices": {
      "post": {
        "operationId": "prices-create",
        "summary": "Crear un precio",
        "description": "El primer paso: `product` es el id de un producto o `{\"name\": \"Plan Gold\"}` para crearlo en el mismo paso. El monto se corrige con `PATCH` mientras nada use el precio (`in_use`); despu\u00e9s, para cambiarlo crea otro precio y archiva este.",
        "tags": [
          "prices"
        ],
        "parameters": [
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/price"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.prices.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "product_inactive",
          "trial_price_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "product": {
                    "type": "string",
                    "description": "Id del producto, u objeto `{name, description?, metadata?, is_addon?, is_trial?}` para crearlo en el mismo paso (un `is_trial` lleva un precio recurrente de $0 con d\u00edas de prueba)."
                  },
                  "amount": {
                    "type": "integer",
                    "description": "En la unidad de `currency`: pesos enteros (`89900`) o centavos de d\u00f3lar (`2900`, m\u00ednimo `100`). `0` solo en el producto de prueba, cuyo precio es recurrente y con d\u00edas de prueba."
                  },
                  "currency": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "COP",
                      "USD"
                    ],
                    "description": "`COP` (por defecto) o `USD`. Wompi cobra en pesos: un precio en d\u00f3lares se convierte en cada cobro con la TRM vigente. Lo que se cobra junto (los \u00edtems de una suscripci\u00f3n, un checkout, una factura \u00fanica) va en una sola moneda (`400 price_currency_mismatch`)."
                  },
                  "type": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "recurring",
                      "one_time"
                    ],
                    "description": "`recurring` (por defecto) o `one_time`: un pago \u00fanico, sin intervalo ni prueba, que se vende en facturas \u00fanicas (`POST /invoices`), nunca en suscripciones ni checkouts."
                  },
                  "recurring": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "`{interval, interval_count?, trial_days?}` (la forma de Stripe), en vez de los tres campos planos."
                  },
                  "interval": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "day",
                      "week",
                      "month",
                      "year"
                    ],
                    "description": "Por defecto `month`."
                  },
                  "interval_count": {
                    "type": "integer",
                    "description": "Por defecto 1."
                  },
                  "trial_days": {
                    "type": "integer",
                    "description": "D\u00edas de prueba (por defecto 0)."
                  },
                  "nickname": {
                    "type": "string",
                    "description": "Nombre interno."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Por defecto `true`."
                  },
                  "metered_rates": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Excedente de un l\u00edmite medido, solo en un precio recurrente: `{clave_del_medidor: {unit_amount, per_units?}}` \u2014 lo que pase del cupo y de las bolsas cuesta `unit_amount` cada `per_units` unidades (por defecto 1), hasta el tope del cliente (`overage_caps` de la suscripci\u00f3n). Sin tarifa, al agotarse responde `402 quota_exhausted`."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "product",
                  "amount"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "prices-list",
        "summary": "Listar precios",
        "description": "",
        "tags": [
          "prices"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "product",
            "in": "query",
            "required": false,
            "description": "Solo los de este producto.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Activos o no.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Solo recurrentes o solo \u00fanicos.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "recurring",
                "one_time"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.prices.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/prices/{id}": {
      "get": {
        "operationId": "prices-retrieve",
        "summary": "Consultar un precio",
        "description": "",
        "tags": [
          "prices"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/price"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.prices.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "prices-update",
        "summary": "Actualizar un precio",
        "description": "`nickname`, `active`, `metadata` y `metered_rates` siempre. Los t\u00e9rminos (`amount`, `currency`, `type`, el intervalo y la prueba) solo mientras nada use el precio (`in_use: false`); si ya lo usa algo responde `400 price_in_use`: crea otro precio y archiva este. Las suscripciones que ya lo usan nunca cambian.",
        "tags": [
          "prices"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/price"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.prices.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_unknown",
          "parameter_invalid",
          "parameter_missing",
          "price_in_use",
          "trial_price_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "nickname": {
                    "type": "string",
                    "description": "Nombre interno."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Archivar o reactivar."
                  },
                  "metered_rates": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Reemplaza las tarifas de excedente. Aplican a las unidades que se tomen desde ahora; cada una conserva la tarifa con la que se tom\u00f3."
                  },
                  "amount": {
                    "type": "integer",
                    "description": "Solo sin uso. En la unidad de `currency`, como al crearlo."
                  },
                  "currency": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "COP",
                      "USD"
                    ],
                    "description": "Solo sin uso, y con `amount` en la unidad de la nueva moneda."
                  },
                  "type": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "recurring",
                      "one_time"
                    ],
                    "description": "Solo sin uso. Pasar a `one_time` quita el intervalo, la prueba y las tarifas de excedente; a `recurring`, queda mensual si no dices otro intervalo."
                  },
                  "recurring": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Solo sin uso. `{interval, interval_count?, trial_days?}`."
                  },
                  "interval": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "day",
                      "week",
                      "month",
                      "year"
                    ],
                    "description": "Solo sin uso."
                  },
                  "interval_count": {
                    "type": "integer",
                    "description": "Solo sin uso."
                  },
                  "trial_days": {
                    "type": "integer",
                    "description": "Solo sin uso."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions": {
      "post": {
        "operationId": "subscriptions-create",
        "summary": "Crear una suscripci\u00f3n",
        "description": "Para un cliente con un m\u00e9todo de pago guardado. Un precio (`price`, con `quantity`) o varios \u00edtems (`items`: plan base + puestos adicionales + adicionales, todos recurrentes y del mismo intervalo); cada periodo se cobra la suma. Sin prueba queda `incomplete` hasta el primer cobro aprobado. Con `billing_cycle_anchor` (una fecha futura, a no m\u00e1s de un ciclo) nace `active` sin cobrar nada ahora: el periodo actual va hasta esa fecha y ah\u00ed es el primer cobro \u2014 para migrar a quien ya pag\u00f3 su periodo en otro sistema. `trial_end` fija el fin de la prueba con una fecha. En producci\u00f3n cuenta para el l\u00edmite de tu plan (`402 active_subscriptions_limit_reached`): cuenta suscripciones, no \u00edtems. Lo habitual es crearla con un checkout.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "resource_missing",
          "parameter_invalid",
          "coupon_not_redeemable",
          "active_subscriptions_limit_reached",
          "product_not_offered",
          "product_coming_soon",
          "quantity_not_supported",
          "addon_requires_feature",
          "addon_requires_plan",
          "addon_included",
          "addon_not_allowed_during_trial",
          "trial_product_misused",
          "trial_already_used",
          "price_inactive",
          "price_not_recurring",
          "price_interval_mismatch",
          "subscription_item_duplicate_price",
          "subscription_items_invalid",
          "quantity_invalid",
          "billing_cycle_anchor_invalid",
          "trial_end_invalid",
          "proration_unavailable"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente."
                  },
                  "price": {
                    "type": "string",
                    "description": "Id de un precio recurrente activo (o env\u00eda `items`)."
                  },
                  "quantity": {
                    "type": "integer",
                    "description": "Cantidad del precio (por defecto 1)."
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "En vez de `price`: `[{price, quantity?, metadata?}]`, de 1 a 20, sin precios repetidos y con el mismo intervalo. `price` de la suscripci\u00f3n ser\u00e1 el del primero."
                  },
                  "default_payment_method": {
                    "type": "string",
                    "description": "Id de un m\u00e9todo del cliente (por defecto, su predeterminado)."
                  },
                  "trial_days": {
                    "type": "integer",
                    "description": "D\u00edas de prueba (por defecto, los del precio)."
                  },
                  "trial_end": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Fin de la prueba (ISO 8601 o timestamp Unix): futuro, a no m\u00e1s de 730 d\u00edas. En vez de `trial_days`."
                  },
                  "billing_cycle_anchor": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Fecha del primer cobro (ISO 8601 o timestamp Unix): futura, a no m\u00e1s de un ciclo del precio ni de 730 d\u00edas. Nace `active`, sin factura ahora. No va con `trial_days` ni `trial_end`."
                  },
                  "proration_behavior": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "none",
                      "create_prorations"
                    ],
                    "description": "Al crear no hay nada que prorratear: `none` o `create_prorations` dan lo mismo."
                  },
                  "trial_key": {
                    "type": "string",
                    "description": "Una prueba por clave (el documento del cliente, un correo): si la suscripci\u00f3n empieza en prueba y la clave ya se us\u00f3 \u2014 aunque sea otro cliente o la anterior ya termin\u00f3 \u2014 responde `409 trial_already_used`. Sin prueba se ignora."
                  },
                  "overage_caps": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Tope de excedente por ventana: `{clave_del_medidor: valor}` (0 = sin excedente). Un medidor que no est\u00e9 vale lo que cuesta el plan. Lo fija el cliente en tu SaaS."
                  },
                  "coupon": {
                    "type": "string",
                    "description": "Id de un cup\u00f3n: rebaja desde la primera factura de periodo."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "subscriptions-list",
        "summary": "Listar suscripciones",
        "description": "",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Estado.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "incomplete",
                "incomplete_expired",
                "trialing",
                "active",
                "past_due",
                "canceled",
                "paused"
              ]
            }
          },
          {
            "name": "customer",
            "in": "query",
            "required": false,
            "description": "Id del cliente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "description": "Id del precio.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "metadata[<clave>]",
            "in": "query",
            "required": false,
            "description": "Solo las que tienen ese par en su metadata (`metadata[legacy_id]=123`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/subscriptions/{id}": {
      "get": {
        "operationId": "subscriptions-retrieve",
        "summary": "Consultar una suscripci\u00f3n",
        "description": "Expande `customer`, `price`, `default_payment_method` o `latest_invoice`.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "subscriptions-update",
        "summary": "Actualizar una suscripci\u00f3n",
        "description": "`price` cambia el \u00fanico \u00edtem; una suscripci\u00f3n de varios \u00edtems los cambia en `/subscription_items` (`400 subscription_has_multiple_items`) o todos a la vez con `items` y `create_prorations` \u2014 as\u00ed cambia de ciclo un plan con adicionales: el primer \u00edtem es el plan y todos van a su intervalo. Con `proration_behavior: none` el precio nuevo aplica desde el siguiente ciclo; con `create_prorations` subir se cobra ya prorrateado (un ciclo m\u00e1s largo empieza un periodo hoy) y aplica cuando se paga \u2014 responde `202` con el `subscription_change` mientras espera su cobro; si falla, la suscripci\u00f3n queda como estaba (`subscription.update_failed`) \u2014 y bajar (o un ciclo m\u00e1s corto) queda para la renovaci\u00f3n.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_missing",
          "parameter_invalid",
          "subscription_not_updatable",
          "subscription_has_multiple_items",
          "price_inactive",
          "price_not_recurring",
          "price_interval_mismatch",
          "price_currency_mismatch",
          "subscription_item_duplicate_price",
          "subscription_item_last",
          "subscription_items_invalid",
          "subscription_change_too_complex",
          "quantity_invalid",
          "proration_unavailable",
          "quote_changed",
          "subscription_update_in_progress",
          "payment_method_required",
          "fixed_term_not_changeable"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "string",
                    "description": "Precio desde el pr\u00f3ximo ciclo."
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "En vez de `price`, solo con `create_prorations` y `expected_amount`: todos los \u00edtems despu\u00e9s del cambio, `[{id?, price, quantity?}]` \u2014 `id` es un \u00edtem actual (sin `quantity` conserva la suya); uno que no est\u00e9 se quita. El \u00edtem del plan va primero, y todos comparten su intervalo (`400 price_interval_mismatch`)."
                  },
                  "default_payment_method": {
                    "type": "string",
                    "description": "M\u00e9todo con el que se cobra."
                  },
                  "cancel_at_period_end": {
                    "type": "boolean",
                    "description": "Cancelar al fin del periodo (o deshacerlo)."
                  },
                  "proration_behavior": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "none",
                      "create_prorations"
                    ],
                    "description": "`none` (por defecto): aplica ya y se cobra desde el siguiente periodo. `create_prorations`: lo que sube el valor se cobra ya prorrateado y aplica cuando Wompi aprueba (`202` con el `subscription_change` si espera su cobro); lo que lo baja queda programado para la renovaci\u00f3n. Pide antes la vista previa (`POST /subscriptions/{id}/preview`)."
                  },
                  "expected_amount": {
                    "type": "integer",
                    "description": "Con `create_prorations`: lo que la vista previa dijo que cuesta ahora. Si ya no cuadra responde `409 quote_changed` con la cotizaci\u00f3n nueva en `quote`."
                  },
                  "overage_caps": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Cambia los topes de excedente: `{clave_del_medidor: valor}` (0 = sin excedente; `null` = vuelve al valor del plan). Las claves que no env\u00edes quedan como estaban."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/preview": {
      "post": {
        "operationId": "subscriptions-preview",
        "summary": "Vista previa de un cambio",
        "description": "Lo que cuesta AHORA cambiar la suscripci\u00f3n, con el mismo c\u00e1lculo que hace el cambio con `create_prorations`: d\u00edas calendario desde hoy hasta el fin del periodo sobre los d\u00edas del periodo, cada l\u00ednea redondeada a la unidad de la moneda. `direction`: `up` (se cobra ya y aplica al pagarse), `down` (queda para la renovaci\u00f3n, sin cobro ni devoluci\u00f3n) o `even` (aplica ya, gratis). Lo que queda bajo el m\u00ednimo de Wompi no se cobra (`below_minimum`). En prueba todo aplica ya, gratis. No cambia nada.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription_quote"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "price_inactive",
          "price_not_recurring",
          "price_interval_mismatch",
          "price_currency_mismatch",
          "subscription_item_duplicate_price",
          "product_not_offered",
          "product_coming_soon",
          "quantity_not_supported",
          "addon_requires_feature",
          "addon_requires_plan",
          "addon_included",
          "addon_not_allowed_during_trial",
          "trial_product_misused"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "string",
                    "description": "Cambio de plan de una suscripci\u00f3n de un \u00edtem."
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Todos los \u00edtems despu\u00e9s del cambio: `[{id?, price, quantity?}]` \u2014 `id` es un \u00edtem actual (sin `quantity` conserva la suya); uno que no est\u00e9 se quita. El \u00edtem del plan va primero: si cambia de intervalo, todos van al suyo (cambio de ciclo de un plan con adicionales)."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/cancel": {
      "post": {
        "operationId": "subscriptions-cancel",
        "summary": "Cancelar una suscripci\u00f3n",
        "description": "Al instante, o al fin del periodo con `at_period_end: true`. Los reembolsos se hacen en Wompi.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.cancel",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "subscription_not_updatable"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "at_period_end": {
                    "type": "boolean",
                    "description": "Por defecto `false`."
                  },
                  "reason": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "requested_by_customer",
                      "requested_by_merchant",
                      "payment_failed",
                      "trial_ended",
                      "refunded",
                      "fixed_term_ended"
                    ],
                    "description": "Motivo."
                  },
                  "comment": {
                    "type": "string",
                    "description": "Comentario."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/pause": {
      "post": {
        "operationId": "subscriptions-pause",
        "summary": "Pausar el cobro",
        "description": "El periodo pagado corre hasta su fin y luego la suscripci\u00f3n queda `paused`: solo lectura (sus derechos), sin deuda ni facturas, hasta que la reanudes \u2014 o sola en `resumes_at`. Solo una `active` o `trialing` sin pagos pendientes. Queda en la bit\u00e1cora (`/actions`).",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.manage",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "subscription_not_pausable",
          "subscription_update_in_progress",
          "parameter_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "resumes_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Cu\u00e1ndo se reanuda sola (despu\u00e9s del fin del periodo). Sin ella, a mano."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Por qu\u00e9 (queda en la bit\u00e1cora)."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/resume": {
      "post": {
        "operationId": "subscriptions-resume",
        "summary": "Reanudar el cobro",
        "description": "Una pausa pedida que no ha empezado se deshace. Una suscripci\u00f3n `paused` empieza un periodo nuevo hoy (un d\u00eda de cobro nuevo) y se cobra ya; sin tarjeta, la factura espera una y queda con pago atrasado.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.manage",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "subscription_not_paused",
          "subscription_not_updatable"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/extend_period": {
      "post": {
        "operationId": "subscriptions-extend-period",
        "summary": "Extender el periodo",
        "description": "D\u00edas gratis: el periodo en curso termina despu\u00e9s y el d\u00eda de cobro se mueve con \u00e9l. Solo una `active` sin pagos pendientes (en prueba, extiende la prueba).",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.manage",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "subscription_not_extendable",
          "subscription_update_in_progress",
          "parameter_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "days": {
                    "type": "integer",
                    "description": "Cu\u00e1ntos d\u00edas m\u00e1s (o `until`)."
                  },
                  "until": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Hasta cu\u00e1ndo (o `days`)."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/extend_trial": {
      "post": {
        "operationId": "subscriptions-extend-trial",
        "summary": "Extender la prueba",
        "description": "La prueba termina en `trial_end` (el primer cobro se mueve con ella). Una prueba m\u00e1s larga se avisa de nuevo tres d\u00edas antes.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.manage",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "trial_not_running",
          "trial_end_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "trial_end": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Nuevo fin de la prueba."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "trial_end"
                ]
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/end_trial": {
      "post": {
        "operationId": "subscriptions-end-trial",
        "summary": "Terminar la prueba",
        "description": "La prueba termina ya: se factura y se cobra el primer periodo (o, si solo tiene el producto de prueba y no se env\u00eda `price`, termina). Con `price` pasa a ese plan (el mismo control que cambiar el precio; con un cup\u00f3n del 100 % el periodo queda pagado sin tarjeta).",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.manage",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "trial_not_running",
          "plan_price_required",
          "price_inactive",
          "price_not_recurring",
          "price_currency_mismatch",
          "subscription_has_multiple_items",
          "subscription_update_in_progress",
          "fixed_term_not_changeable",
          "product_not_offered",
          "product_coming_soon",
          "quantity_not_supported"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "string",
                    "description": "El plan al que pasa (`price_\u2026`): nunca el de la prueba ni el de un adicional. Con varios \u00edtems, c\u00e1mbialos antes."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/discount": {
      "post": {
        "operationId": "subscriptions-discount-apply",
        "summary": "Aplicar un cup\u00f3n",
        "description": "Reemplaza el descuento vigente (uno por suscripci\u00f3n). Rebaja el cobro (`invoice`) del periodo que sigue abierto (si no hay un cobro en curso; nunca la sube: emite `invoice.updated`, o la paga si queda en $0 y la suscripci\u00f3n se activa) y las de los periodos que vienen. Un cup\u00f3n `once` se aplica una vez por suscripci\u00f3n; uno en valor fijo, solo en su moneda.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.manage",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "coupon_not_redeemable",
          "subscription_not_updatable"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "coupon": {
                    "type": "string",
                    "description": "Id del cup\u00f3n."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "coupon"
                ]
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "subscriptions-discount-delete",
        "summary": "Quitar el descuento",
        "description": "Los cobros (`invoice`) ya abiertos lo conservan.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.manage",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "discount_missing"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/subscriptions/{id}/actions": {
      "get": {
        "operationId": "subscriptions-actions",
        "summary": "Bit\u00e1cora de la suscripci\u00f3n",
        "description": "Lo que se hizo a mano (pausa, d\u00edas gratis, cupones, pagos manuales, reembolsos): qui\u00e9n, por qu\u00e9 y el detalle, de lo m\u00e1s reciente a lo m\u00e1s antiguo.",
        "tags": [
          "subscriptions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscriptions.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/subscription_items": {
      "post": {
        "operationId": "subscription-items-create",
        "summary": "Agregar un \u00edtem a una suscripci\u00f3n",
        "description": "Un precio recurrente \u00d7 cantidad (un puesto adicional, un adicional), con el intervalo de la suscripci\u00f3n. Con `proration_behavior: none` se cobra desde el SIGUIENTE periodo. Con `create_prorations` se cobra ya por los d\u00edas que quedan y el \u00edtem llega cuando se paga (`202` con el `subscription_change`); bajo el m\u00ednimo de Wompi entra gratis hasta la renovaci\u00f3n; agregar uno que estaba por quitarse lo deshace. Emite `subscription.updated` con los \u00edtems anteriores en `previous_attributes.items`.",
        "tags": [
          "subscription_items"
        ],
        "parameters": [
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription_item"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscription_items.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "price_inactive",
          "price_not_recurring",
          "price_interval_mismatch",
          "subscription_item_duplicate_price",
          "subscription_items_invalid",
          "quantity_invalid",
          "subscription_not_updatable",
          "proration_unavailable",
          "product_not_offered",
          "product_coming_soon",
          "quantity_not_supported",
          "addon_requires_feature",
          "addon_requires_plan",
          "addon_included",
          "addon_not_allowed_during_trial",
          "trial_product_misused"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "subscription": {
                    "type": "string",
                    "description": "Id de la suscripci\u00f3n."
                  },
                  "price": {
                    "type": "string",
                    "description": "Id de un precio recurrente activo."
                  },
                  "quantity": {
                    "type": "integer",
                    "description": "Cantidad (por defecto 1)."
                  },
                  "proration_behavior": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "none",
                      "create_prorations"
                    ],
                    "description": "`none` (por defecto): aplica ya y se cobra desde el siguiente periodo. `create_prorations`: lo que sube el valor se cobra ya prorrateado y aplica cuando Wompi aprueba (`202` con el `subscription_change` si espera su cobro); lo que lo baja queda programado para la renovaci\u00f3n. Pide antes la vista previa (`POST /subscriptions/{id}/preview`)."
                  },
                  "expected_amount": {
                    "type": "integer",
                    "description": "Con `create_prorations`: lo que la vista previa dijo que cuesta ahora. Si ya no cuadra responde `409 quote_changed` con la cotizaci\u00f3n nueva en `quote`."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "subscription",
                  "price"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "subscription-items-list",
        "summary": "Listar los \u00edtems de una suscripci\u00f3n",
        "description": "Del m\u00e1s reciente al m\u00e1s antiguo; con `subscription`, solo los de esa suscripci\u00f3n (que ya los trae todos en `items`).",
        "tags": [
          "subscription_items"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "subscription",
            "in": "query",
            "required": false,
            "description": "Id de la suscripci\u00f3n.",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscription_items.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/subscription_items/{id}": {
      "get": {
        "operationId": "subscription-items-retrieve",
        "summary": "Consultar un \u00edtem",
        "description": "",
        "tags": [
          "subscription_items"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription_item"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscription_items.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "subscription-items-update",
        "summary": "Cambiar un \u00edtem",
        "description": "La cantidad o el precio (recurrente, mismo intervalo). Con `none`, desde el siguiente periodo; con `create_prorations`, subir se cobra ya prorrateado y bajar queda para la renovaci\u00f3n (`scheduled_quantity` / `scheduled_price`). Cambiar el precio del primer \u00edtem reemplaza un `pending_price`.",
        "tags": [
          "subscription_items"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/subscription_item"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscription_items.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "price_inactive",
          "price_not_recurring",
          "price_interval_mismatch",
          "subscription_item_duplicate_price",
          "quantity_invalid",
          "subscription_not_updatable",
          "proration_unavailable",
          "product_not_offered",
          "product_coming_soon",
          "quantity_not_supported",
          "addon_requires_feature",
          "addon_requires_plan",
          "addon_included",
          "addon_not_allowed_during_trial",
          "trial_product_misused"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "string",
                    "description": "Otro precio recurrente del mismo intervalo."
                  },
                  "quantity": {
                    "type": "integer",
                    "description": "Cantidad nueva."
                  },
                  "proration_behavior": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "none",
                      "create_prorations"
                    ],
                    "description": "`none` (por defecto): aplica ya y se cobra desde el siguiente periodo. `create_prorations`: lo que sube el valor se cobra ya prorrateado y aplica cuando Wompi aprueba (`202` con el `subscription_change` si espera su cobro); lo que lo baja queda programado para la renovaci\u00f3n. Pide antes la vista previa (`POST /subscriptions/{id}/preview`)."
                  },
                  "expected_amount": {
                    "type": "integer",
                    "description": "Con `create_prorations`: lo que la vista previa dijo que cuesta ahora. Si ya no cuadra responde `409 quote_changed` con la cotizaci\u00f3n nueva en `quote`."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "subscription-items-delete",
        "summary": "Quitar un \u00edtem",
        "description": "Deja de cobrarse desde el siguiente periodo, sin reembolso. Con `create_prorations` el \u00edtem se queda hasta la renovaci\u00f3n (`scheduled_quantity: 0`) y se responde el \u00edtem; agregarlo antes lo deshace. El \u00faltimo \u00edtem no se quita (`400 subscription_item_last`): cancela la suscripci\u00f3n.",
        "tags": [
          "subscription_items"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deleted"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.subscription_items.destroy",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "subscription_item_last",
          "subscription_not_updatable",
          "proration_unavailable"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "proration_behavior": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "none",
                      "create_prorations"
                    ],
                    "description": "`none` (por defecto, se quita ya) o `create_prorations` (se queda hasta la renovaci\u00f3n)."
                  },
                  "expected_amount": {
                    "type": "integer",
                    "description": "Con `create_prorations`: `0` (quitar nunca cobra)."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/payment_methods": {
      "post": {
        "operationId": "payment-methods-create",
        "summary": "Importar una fuente de pago de Wompi",
        "description": "Para migrar a Bucli a un cliente que ya tiene su tarjeta guardada en TU cuenta de Wompi (sin ped\u00edrsela otra vez). Bucli consulta la fuente en Wompi con tu llave privada: tiene que existir en tu cuenta, estar `AVAILABLE` y ser `CARD`; guarda la marca, los \u00faltimos cuatro, el vencimiento y la evidencia de la importaci\u00f3n (cu\u00e1ndo, con qu\u00e9 llave, la respuesta de Wompi). Guarda tu id anterior en `metadata.legacy_id`. Idempotente por fuente: la misma para el mismo cliente responde `200` con el m\u00e9todo ya guardado; para otro cliente, `409 payment_method_attached_elsewhere`. Queda predeterminado con `make_default` o si el cliente no ten\u00eda uno. Solo con la llave secreta (`sk_`), desde tu servidor. Emite `payment_method.attached`.",
        "tags": [
          "payment_methods"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_method"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payment_methods.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "customer_deleted",
          "secret_key_required",
          "wompi_payment_source_missing",
          "wompi_payment_source_unavailable",
          "wompi_payment_source_unsupported",
          "payment_method_attached_elsewhere",
          "wompi_credentials_missing",
          "wompi_credentials_invalid",
          "wompi_unavailable"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente (`cus_\u2026`)."
                  },
                  "wompi_payment_source_id": {
                    "type": "string",
                    "description": "Id num\u00e9rico de la fuente de pago en Wompi."
                  },
                  "make_default": {
                    "type": "boolean",
                    "description": "Hacerla la predeterminada (por defecto `false`)."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer",
                  "wompi_payment_source_id"
                ]
              }
            }
          }
        }
      }
    },
    "/payment_methods/{id}": {
      "get": {
        "operationId": "payment-methods-retrieve",
        "summary": "Consultar un m\u00e9todo de pago",
        "description": "Marca, \u00faltimos cuatro y vencimiento; nunca el n\u00famero de la tarjeta.",
        "tags": [
          "payment_methods"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_method"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payment_methods.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "delete": {
        "operationId": "payment-methods-delete",
        "summary": "Quitar un m\u00e9todo de pago",
        "description": "Responde el m\u00e9todo con `customer: null`.",
        "tags": [
          "payment_methods"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_method"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payment_methods.destroy",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "payment_method_required"
        ]
      }
    },
    "/payment_methods/{id}/default": {
      "post": {
        "operationId": "payment-methods-default",
        "summary": "Hacer predeterminado un m\u00e9todo de pago",
        "description": "Si el cliente tiene una suscripci\u00f3n con pago atrasado, el motor reintenta el cobro.",
        "tags": [
          "payment_methods"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_method"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payment_methods.default",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "payment_method_unavailable"
        ]
      }
    },
    "/payment_methods/{id}/backup": {
      "post": {
        "operationId": "payment-methods-backup",
        "summary": "Hacer de respaldo un m\u00e9todo de pago",
        "description": "La segunda tarjeta del cliente: en cada ronda de cobro se intenta enseguida despu\u00e9s de la predeterminada, y pasa a predeterminada si esa se suspende (un rechazo duro) o se quita. Solo una por cliente.",
        "tags": [
          "payment_methods"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_method"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payment_methods.default",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "payment_method_unavailable",
          "payment_method_is_default"
        ]
      }
    },
    "/invoices": {
      "post": {
        "operationId": "invoices-create",
        "summary": "Crear una factura \u00fanica (un cobro \u00fanico)",
        "description": "Un pago \u00fanico sin suscripci\u00f3n \u2014un paquete, un servicio adicional\u2014: `lines` con precios de pago \u00fanico (`type: one_time`) \u00d7 cantidad, o un `amount` con su `description`. Con `auto_charge` (por defecto) se abre y se cobra de una a la tarjeta (`default_payment_method` o la predeterminada del cliente) por el mismo camino de todo cobro: referencia determinista, frenos de cobro, idempotencia. Responde la factura (normalmente `open` con el cobro en curso); el resultado llega con `invoice.paid` o `invoice.payment_failed`. Con `retry: false` (por defecto) un rechazo NO se reintenta solo: la factura queda abierta hasta que la cobres otra vez (`/invoices/{id}/pay`) o la anules. Si un freno de cobros la detiene, se cobra sola cuando se libere. Usa `Idempotency-Key`.",
        "tags": [
          "invoices"
        ],
        "parameters": [
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/invoice"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.invoices.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "customer_deleted",
          "price_inactive",
          "price_not_one_time",
          "quantity_invalid",
          "invoice_lines_invalid",
          "invoice_amount_too_small",
          "payment_method_unavailable",
          "customer_payment_method_missing"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente."
                  },
                  "lines": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "`[{price, quantity?, description?, metadata?}]`, de 1 a 20 precios de pago \u00fanico activos."
                  },
                  "amount": {
                    "type": "integer",
                    "description": "Monto libre en vez de `lines` (con `description`), en la unidad de `currency`."
                  },
                  "currency": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "COP",
                      "USD"
                    ],
                    "description": "Con `amount`: `COP` (por defecto) o `USD`. Con `lines`, la de sus precios."
                  },
                  "description": {
                    "type": "string",
                    "description": "Qu\u00e9 se cobra; obligatoria con `amount`."
                  },
                  "default_payment_method": {
                    "type": "string",
                    "description": "Id de un m\u00e9todo del cliente (por defecto, su predeterminado)."
                  },
                  "auto_charge": {
                    "type": "boolean",
                    "description": "Cobrarla ya (por defecto `true`); con `false` espera a `/pay`."
                  },
                  "retry": {
                    "type": "boolean",
                    "description": "Reintentar un rechazo seg\u00fan tu calendario (por defecto `false`)."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "invoices-list",
        "summary": "Listar facturas",
        "description": "",
        "tags": [
          "invoices"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Estado.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "draft",
                "open",
                "paid",
                "void",
                "uncollectible"
              ]
            }
          },
          {
            "name": "customer",
            "in": "query",
            "required": false,
            "description": "Id del cliente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "subscription",
            "in": "query",
            "required": false,
            "description": "Id de la suscripci\u00f3n.",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.invoices.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/invoices/{id}/lines": {
      "get": {
        "operationId": "invoices-lines",
        "summary": "Listar las l\u00edneas de una factura",
        "description": "Del m\u00e1s reciente al m\u00e1s antiguo. `invoice.lines` ya las trae todas.",
        "tags": [
          "invoices"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.invoices.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/invoices/{id}": {
      "get": {
        "operationId": "invoices-retrieve",
        "summary": "Consultar una factura",
        "description": "",
        "tags": [
          "invoices"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/invoice"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.invoices.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/invoices/{id}/pay": {
      "post": {
        "operationId": "invoices-pay",
        "summary": "Cobrar una factura ahora",
        "description": "Reintenta el cobro de inmediato con el m\u00e9todo de la suscripci\u00f3n. Solo facturas `open`. Si un freno de cobros lo detiene responde `409 invoice_charge_blocked` con el motivo, y la factura se cobra sola despu\u00e9s.",
        "tags": [
          "invoices"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/invoice"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.invoices.pay",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "invoice_not_open",
          "invoice_payment_in_progress",
          "invoice_charge_blocked"
        ]
      }
    },
    "/invoices/{id}/void": {
      "post": {
        "operationId": "invoices-void",
        "summary": "Anular una factura",
        "description": "Solo `draft` u `open`; emite `invoice.voided`.",
        "tags": [
          "invoices"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/invoice"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.invoices.void",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "invoice_not_voidable",
          "invoice_payment_in_progress"
        ]
      }
    },
    "/invoices/{id}/mark_paid": {
      "post": {
        "operationId": "invoices-mark-paid",
        "summary": "Registrar un pago manual",
        "description": "La factura se pag\u00f3 por fuera de Wompi (una transferencia): queda pagada con su referencia (\u00fanica entre tus pagos manuales), como un pago `source: manual`, y la suscripci\u00f3n sigue como con cualquier pago \u2014 paga el periodo debido o activa la suscripci\u00f3n. Su reembolso solo se registra.",
        "tags": [
          "invoices"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/invoice"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.invoices.mark_paid",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "invoice_not_open",
          "invoice_payment_in_progress",
          "manual_payment_reference_used",
          "exchange_rate_unavailable"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reference": {
                    "type": "string",
                    "description": "Referencia de la transferencia."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Nota (queda en la bit\u00e1cora)."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "reference"
                ]
              }
            }
          }
        }
      }
    },
    "/payments": {
      "get": {
        "operationId": "payments-list",
        "summary": "Listar pagos",
        "description": "Cada intento de cobro enviado a Wompi, aprobado o no.",
        "tags": [
          "payments"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "invoice",
            "in": "query",
            "required": false,
            "description": "Id de la factura.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Estado.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "pending",
                "approved",
                "declined",
                "error",
                "voided"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payments.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/payments/{id}": {
      "get": {
        "operationId": "payments-retrieve",
        "summary": "Consultar un pago",
        "description": "",
        "tags": [
          "payments"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payments.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/payments/{id}/refund": {
      "post": {
        "operationId": "payments-refund",
        "summary": "Reembolsar un pago",
        "description": "Devuelve `amount` pesos (por defecto todo lo que queda) por Wompi, en tres pasos como todo cobro. Responde el `refund`: `succeeded`, `pending` (Wompi a\u00fan no responde: se consulta solo) o `failed` con el motivo. Hecho, emite `charge.refunded`. El reembolso total de una bolsa la retira; el de un adicional no lo quita. `cancel_subscription: true` cancela la suscripci\u00f3n (motivo `refunded`). Un pago manual se reembolsa solo registrado.",
        "tags": [
          "payments"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/refund"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payments.refund",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "payment_not_refundable",
          "refund_in_progress",
          "parameter_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "amount": {
                    "type": "integer",
                    "description": "Pesos a devolver (por defecto, todo lo que queda)."
                  },
                  "reason": {
                    "type": "string",
                    "description": "Motivo."
                  },
                  "cancel_subscription": {
                    "type": "boolean",
                    "description": "Cancelar la suscripci\u00f3n al quedar hecho."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/payments/{id}/void": {
      "post": {
        "operationId": "payments-void",
        "summary": "Anular un pago",
        "description": "Anula en Wompi un cobro con tarjeta aprobado HOY (hora de Bogot\u00e1), completo y sin reembolsos; si no, reemb\u00f3lsalo. El pago y su factura quedan anulados. Responde el `refund` (`kind: void`).",
        "tags": [
          "payments"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/refund"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.payments.refund",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "payment_not_refundable",
          "payment_not_voidable",
          "refund_in_progress",
          "parameter_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "reason": {
                    "type": "string",
                    "description": "Motivo."
                  },
                  "cancel_subscription": {
                    "type": "boolean",
                    "description": "Cancelar la suscripci\u00f3n al quedar hecha."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/coupons": {
      "post": {
        "operationId": "coupons-create",
        "summary": "Crear un cup\u00f3n",
        "description": "Un porcentaje o un valor fijo por periodo, una vez, N meses o para siempre, sobre el plan, los adicionales o ambos. Rebaja solo las facturas de periodo (la primera y cada renovaci\u00f3n, con sus reintentos); los prorrateos, el excedente y los pagos \u00fanicos van a precio de lista. Si el total con descuento queda bajo el m\u00ednimo de Wompi, el periodo pasa gratis. Una vez aplicado a una suscripci\u00f3n, sus t\u00e9rminos no cambian.",
        "tags": [
          "coupons"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/coupon"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.coupons.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "percent_off": {
                    "type": "string",
                    "description": "Porcentaje, de 0,01 a 100 (o `amount_off`)."
                  },
                  "amount_off": {
                    "type": "integer",
                    "description": "Valor por periodo, en la unidad de `currency` (o `percent_off`)."
                  },
                  "currency": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "COP",
                      "USD"
                    ],
                    "description": "Con `amount_off` (por defecto `COP`)."
                  },
                  "duration": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "once",
                      "repeating",
                      "forever"
                    ],
                    "description": "Duraci\u00f3n."
                  },
                  "duration_in_months": {
                    "type": "integer",
                    "description": "Con `repeating`, de 1 a 120."
                  },
                  "applies_to": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "all",
                      "plan",
                      "addons"
                    ],
                    "description": "Por defecto `all`."
                  },
                  "max_redemptions": {
                    "type": "integer",
                    "description": "Tope de suscripciones."
                  },
                  "redeem_by": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Fecha l\u00edmite para aplicarlo."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "name",
                  "duration"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "coupons-list",
        "summary": "Listar cupones",
        "description": "Los que no se han eliminado, del m\u00e1s reciente al m\u00e1s antiguo.",
        "tags": [
          "coupons"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.coupons.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited"
        ]
      }
    },
    "/coupons/{id}": {
      "get": {
        "operationId": "coupons-retrieve",
        "summary": "Consultar un cup\u00f3n",
        "description": "",
        "tags": [
          "coupons"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/coupon"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.coupons.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "coupons-update",
        "summary": "Editar un cup\u00f3n",
        "description": "Nombre, `active`, `max_redemptions`, `redeem_by` y metadata. El descuento, la moneda, la duraci\u00f3n y `applies_to` solo mientras no se haya aplicado (`coupon_terms_frozen` despu\u00e9s: crea otro).",
        "tags": [
          "coupons"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/coupon"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.coupons.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "coupon_terms_frozen"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "`false`: no se aplica a nadie m\u00e1s."
                  },
                  "max_redemptions": {
                    "type": "integer",
                    "description": "Tope de suscripciones."
                  },
                  "redeem_by": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Fecha l\u00edmite."
                  },
                  "percent_off": {
                    "type": "string",
                    "description": "Solo sin usos."
                  },
                  "amount_off": {
                    "type": "integer",
                    "description": "Solo sin usos."
                  },
                  "currency": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "COP",
                      "USD"
                    ],
                    "description": "Solo sin usos."
                  },
                  "duration": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "once",
                      "repeating",
                      "forever"
                    ],
                    "description": "Solo sin usos."
                  },
                  "duration_in_months": {
                    "type": "integer",
                    "description": "Solo sin usos."
                  },
                  "applies_to": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "all",
                      "plan",
                      "addons"
                    ],
                    "description": "Solo sin usos."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "coupons-delete",
        "summary": "Eliminar un cup\u00f3n",
        "description": "No se aplica a nadie m\u00e1s; los descuentos ya aplicados siguen.",
        "tags": [
          "coupons"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deleted"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.coupons.destroy",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/refunds": {
      "get": {
        "operationId": "refunds-list",
        "summary": "Listar reembolsos",
        "description": "Reembolsos y anulaciones, del m\u00e1s reciente al m\u00e1s antiguo.",
        "tags": [
          "refunds"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "payment",
            "in": "query",
            "required": false,
            "description": "Id del pago.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "invoice",
            "in": "query",
            "required": false,
            "description": "Id de la factura.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Estado.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "pending",
                "succeeded",
                "failed"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.refunds.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/refunds/{id}": {
      "get": {
        "operationId": "refunds-retrieve",
        "summary": "Consultar un reembolso",
        "description": "",
        "tags": [
          "refunds"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/refund"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.refunds.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/fixed_term_offers": {
      "post": {
        "operationId": "fixed-term-offers-create",
        "summary": "Crear una oferta de plazo fijo",
        "description": "Un paquete \u00fanico para un cliente: plan base y adicionales (`items`), unidades de medidores para todo el plazo (`units`), `days` y un precio en pesos, pagado una vez con un link de pago de un solo uso de TU cuenta de Wompi, que vence en `link_days` (7 por defecto) y se le env\u00eda al cliente por correo. Pagado, la suscripci\u00f3n queda activa esos d\u00edas con esos derechos (las unidades como bolsas que vencen con el plazo), no renueva ni tiene gracia, y al vencer queda cancelada con `fixed_term_ended`. Un pago que no se puede aplicar (doble, oferta vencida, otro valor) queda \u00abpor devolver\u00bb y se te avisa. Una oferta abierta por cliente.",
        "tags": [
          "fixed_term_offers"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fixed_term_offer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.fixed_term_offers.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "invoice_amount_too_small",
          "fixed_term_offer_open",
          "fixed_term_unavailable",
          "active_subscriptions_limit_reached",
          "wompi_unavailable",
          "product_not_offered",
          "product_coming_soon",
          "quantity_not_supported",
          "addon_requires_feature",
          "addon_requires_plan",
          "addon_included",
          "addon_not_allowed_during_trial",
          "trial_product_misused"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente."
                  },
                  "items": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "`[{price, quantity}]`: el plan base primero, luego los adicionales."
                  },
                  "units": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "`[{meter, units}]`: la clave del medidor y las unidades para todo el plazo."
                  },
                  "days": {
                    "type": "integer",
                    "description": "D\u00edas del plazo."
                  },
                  "amount": {
                    "type": "integer",
                    "description": "Precio en pesos (desde el m\u00ednimo de Wompi)."
                  },
                  "name": {
                    "type": "string",
                    "description": "Nombre (por defecto \u00ab<plan> por N d\u00edas\u00bb)."
                  },
                  "link_days": {
                    "type": "integer",
                    "description": "D\u00edas que vive el link de pago, de 1 a 30."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer",
                  "items",
                  "days",
                  "amount"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "fixed-term-offers-list",
        "summary": "Listar ofertas de plazo fijo",
        "description": "",
        "tags": [
          "fixed_term_offers"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "customer",
            "in": "query",
            "required": false,
            "description": "Id del cliente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Estado.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "open",
                "paid",
                "expired",
                "canceled"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.fixed_term_offers.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/fixed_term_offers/{id}": {
      "get": {
        "operationId": "fixed-term-offers-retrieve",
        "summary": "Consultar una oferta de plazo fijo",
        "description": "",
        "tags": [
          "fixed_term_offers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fixed_term_offer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.fixed_term_offers.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/fixed_term_offers/{id}/cancel": {
      "post": {
        "operationId": "fixed-term-offers-cancel",
        "summary": "Cancelar una oferta de plazo fijo",
        "description": "Solo una que espera el pago; su link de pago deja de funcionar.",
        "tags": [
          "fixed_term_offers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/fixed_term_offer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "billing.fixed_term_offers.cancel",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "fixed_term_offer_not_open"
        ]
      }
    },
    "/events": {
      "get": {
        "operationId": "events-list",
        "summary": "Listar eventos",
        "description": "Los de los \u00faltimos 30 d\u00edas, del m\u00e1s reciente al m\u00e1s antiguo. Se ordenan por el momento en que se crearon, y un evento puede aparecer en la lista un instante despu\u00e9s que otro m\u00e1s reciente (se confirma m\u00e1s tarde). Si sigues los nuevos con `ending_before`, no uses como cursor el \u00faltimo que viste: pide de nuevo desde uno de hace al menos un minuto y descarta los `id` que ya procesaste. Los webhooks entregan cada evento al menos una vez, sin este cuidado.",
        "tags": [
          "events"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Un tipo (`invoice.paid`) o un grupo (`invoice.*`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.events.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/events/{id}": {
      "get": {
        "operationId": "events-retrieve",
        "summary": "Consultar un evento",
        "description": "",
        "tags": [
          "events"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/event"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.events.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/events/{id}/resend": {
      "post": {
        "operationId": "events-resend",
        "summary": "Reenviar un evento",
        "description": "Lo entrega otra vez, con el mismo `id`, a tus endpoints activos que lo escuchan, o solo a `webhook_endpoint` (aunque est\u00e9 desactivado). Requiere un plan con webhooks.",
        "tags": [
          "events"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/event"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.events.resend",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "feature_not_available"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "webhook_endpoint": {
                    "type": "string",
                    "description": "Id de un endpoint (`we_\u2026`)."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/webhook_endpoints": {
      "post": {
        "operationId": "webhook-endpoints-create",
        "summary": "Crear un endpoint de webhook",
        "description": "La respuesta trae `secret` (`whsec_\u2026`) **una sola vez**: gu\u00e1rdalo para verificar las firmas (si repites la petici\u00f3n con la misma `Idempotency-Key` responde `409 webhook_secret_unavailable_on_replay`, nunca el secreto). La URL debe ser HTTPS y p\u00fablica. En producci\u00f3n el propietario de la cuenta recibe un correo con la URL. Desde el dashboard, un endpoint de producci\u00f3n lo crea solo el propietario o un administrador (`webhooks.webhook_endpoints.manage_live`) y pide confirmar la identidad (`password` o `code` en el cuerpo).",
        "tags": [
          "webhook_endpoints"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/webhook_endpoint"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.webhook_endpoints.create",
        "x-plan-module": "webhooks",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "url_invalid",
          "webhook_endpoint_limit_reached",
          "webhook_secret_unavailable_on_replay",
          "permission_denied",
          "reauth_failed"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "URL HTTPS."
                  },
                  "enabled_events": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Tipos de evento, o `[\"*\"]`."
                  },
                  "description": {
                    "type": "string",
                    "description": "Para qu\u00e9 es."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "url",
                  "enabled_events"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "webhook-endpoints-list",
        "summary": "Listar endpoints de webhook",
        "description": "",
        "tags": [
          "webhook_endpoints"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.webhook_endpoints.list",
        "x-plan-module": "webhooks",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited"
        ]
      }
    },
    "/webhook_endpoints/{id}": {
      "get": {
        "operationId": "webhook-endpoints-retrieve",
        "summary": "Consultar un endpoint de webhook",
        "description": "Nunca trae el secreto.",
        "tags": [
          "webhook_endpoints"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/webhook_endpoint"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.webhook_endpoints.retrieve",
        "x-plan-module": "webhooks",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "webhook-endpoints-update",
        "summary": "Actualizar un endpoint de webhook",
        "description": "`disabled: true` lo desactiva (sus entregas pendientes se omiten); `false` lo reactiva. Si cambia la `url` de un endpoint de producci\u00f3n, guardamos la anterior y avisamos por correo al propietario; desde el dashboard solo lo hace el propietario o un administrador y pide confirmar la identidad.",
        "tags": [
          "webhook_endpoints"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/webhook_endpoint"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.webhook_endpoints.update",
        "x-plan-module": "webhooks",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "url_invalid",
          "permission_denied",
          "reauth_failed"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "url": {
                    "type": "string",
                    "description": "URL HTTPS."
                  },
                  "enabled_events": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Tipos de evento."
                  },
                  "description": {
                    "type": "string",
                    "description": "Para qu\u00e9 es."
                  },
                  "disabled": {
                    "type": "boolean",
                    "description": "Desactivar o reactivar."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "webhook-endpoints-delete",
        "summary": "Eliminar un endpoint de webhook",
        "description": "",
        "tags": [
          "webhook_endpoints"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deleted"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.webhook_endpoints.destroy",
        "x-plan-module": "webhooks",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/webhook_endpoints/{id}/roll_secret": {
      "post": {
        "operationId": "webhook-endpoints-roll-secret",
        "summary": "Regenerar el secreto de firma",
        "description": "Responde el secreto nuevo una sola vez. Durante 24 horas cada entrega trae dos firmas `v1` en `Bucli-Signature` \u2014la del secreto anterior y, la \u00faltima, la del nuevo\u2014: acepta la entrega si cualquiera coincide y despliega el nuevo secreto en ese plazo; despu\u00e9s solo firma el nuevo.",
        "tags": [
          "webhook_endpoints"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/webhook_endpoint"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "webhooks.webhook_endpoints.roll_secret",
        "x-plan-module": "webhooks",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/account": {
      "get": {
        "operationId": "account-retrieve",
        "summary": "Consultar la cuenta",
        "description": "Tu comercio como lo ve la API en el modo de la llave.",
        "tags": [
          "account"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/account"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "developers.account.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited"
        ]
      }
    },
    "/checkout_sessions": {
      "post": {
        "operationId": "checkout-sessions-create",
        "summary": "Crear una sesi\u00f3n de checkout",
        "description": "Responde la `url` de la p\u00e1gina de pago hospedada (`pay.bucli.co/c/\u2026`): redirige a tu cliente ah\u00ed. Ah\u00ed ve el plan con tu marca, acepta los t\u00e9rminos de Wompi y escribe la tarjeta, que se tokeniza directo con Wompi (Bucli nunca la ve). Al pagar se crean el cliente, la tarjeta y la suscripci\u00f3n, y vuelve a `success_url` con `?session_id=cs_\u2026`. Vence en 24 horas. Con `line_items` la p\u00e1gina muestra cada l\u00ednea y el total, y la suscripci\u00f3n nace con esos \u00edtems. Una llave publicable (`pk_`) tambi\u00e9n la crea desde el navegador, pero sin `customer`, `trial_days`, `customer_fields`, `client_reference_id`, `metadata` ni `subscription_data` (`403 secret_key_required`).",
        "tags": [
          "checkout_sessions"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/checkout.session"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.checkout_sessions.create",
        "x-plan-module": "checkout",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "price_inactive",
          "price_not_recurring",
          "price_interval_mismatch",
          "subscription_item_duplicate_price",
          "subscription_items_invalid",
          "quantity_invalid",
          "secret_key_required",
          "url_unavailable_on_replay"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "string",
                    "description": "Precio que se suscribe (`price_\u2026`); o `line_items`."
                  },
                  "quantity": {
                    "type": "integer",
                    "description": "Cantidad del `price` (1\u201310.000, por defecto 1); no con `line_items`."
                  },
                  "line_items": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "`[{price, quantity}]`: el plan base, los puestos y los adicionales, en orden (el primero es el `price` del objeto). Una sola l\u00ednea con `price` (+ `quantity`, por defecto 1) o varias con `line_items` (como Stripe): de 1 a 20, precios recurrentes del mismo intervalo, cada precio una vez."
                  },
                  "success_url": {
                    "type": "string",
                    "description": "A d\u00f3nde vuelve al terminar (https en producci\u00f3n)."
                  },
                  "cancel_url": {
                    "type": "string",
                    "description": "A d\u00f3nde vuelve si se arrepiente."
                  },
                  "customer": {
                    "type": "string",
                    "description": "Cliente existente (`cus_\u2026`); no con una llave `pk_`."
                  },
                  "customer_email": {
                    "type": "string",
                    "description": "Correo del cliente, fijo en la p\u00e1gina (en vez de `customer`)."
                  },
                  "customer_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "enum": [
                      "name",
                      "legal_id",
                      "phone"
                    ],
                    "description": "Datos a pedir adem\u00e1s del correo (por defecto `[\"name\"]`)."
                  },
                  "trial_days": {
                    "type": "integer",
                    "description": "D\u00edas de prueba (0\u2013730); por defecto los del precio."
                  },
                  "client_reference_id": {
                    "type": "string",
                    "description": "Tu referencia, para reconocer la sesi\u00f3n en el webhook."
                  },
                  "subscription_data": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Lo que lleva la suscripci\u00f3n que se crea: `metadata` (hasta 20 pares) y `trial_days` (lo mismo que `trial_days`; si env\u00edas los dos deben coincidir). No con una llave `pk_`."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "success_url"
                ]
              }
            }
          }
        }
      }
    },
    "/checkout_sessions/{id}": {
      "get": {
        "operationId": "checkout-sessions-retrieve",
        "summary": "Consultar una sesi\u00f3n de checkout",
        "description": "\u00dasala al volver a tu `success_url` para saber qu\u00e9 suscripci\u00f3n qued\u00f3 creada.",
        "tags": [
          "checkout_sessions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/checkout.session"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.checkout_sessions.retrieve",
        "x-plan-module": "checkout",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/checkout_sessions/{id}/expire": {
      "post": {
        "operationId": "checkout-sessions-expire",
        "summary": "Vencer una sesi\u00f3n de checkout",
        "description": "Cierra una sesi\u00f3n abierta: su p\u00e1gina ya no recibe pagos y se emite `checkout.session.expired`. Una sesi\u00f3n completada, vencida o con un cobro esperando respuesta de Wompi responde `409 checkout_session_not_expirable`.",
        "tags": [
          "checkout_sessions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/checkout.session"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.checkout_sessions.expire",
        "x-plan-module": "checkout",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "checkout_session_not_expirable"
        ]
      }
    },
    "/payment_links": {
      "post": {
        "operationId": "payment-links-create",
        "summary": "Crear un enlace de pago",
        "description": "Una URL p\u00fablica (`pay.bucli.co/l/\u2026`) para vender un plan sin c\u00f3digo, por WhatsApp o Instagram: cada visita abre un checkout nuevo con sus l\u00edneas (`price` o `line_items`).",
        "tags": [
          "payment_links"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_link"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.payment_links.create",
        "x-plan-module": "checkout",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "price_inactive",
          "price_not_recurring",
          "price_interval_mismatch",
          "subscription_item_duplicate_price",
          "subscription_items_invalid",
          "quantity_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "price": {
                    "type": "string",
                    "description": "Precio que vende (`price_\u2026`); o `line_items`."
                  },
                  "quantity": {
                    "type": "integer",
                    "description": "Cantidad del `price` (1\u201310.000, por defecto 1); no con `line_items`."
                  },
                  "line_items": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "`[{price, quantity}]`: el plan base, los puestos y los adicionales, en orden (el primero es el `price` del objeto). Una sola l\u00ednea con `price` (+ `quantity`, por defecto 1) o varias con `line_items` (como Stripe): de 1 a 20, precios recurrentes del mismo intervalo, cada precio una vez."
                  },
                  "customer_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "enum": [
                      "name",
                      "legal_id",
                      "phone"
                    ],
                    "description": "Datos a pedir adem\u00e1s del correo."
                  },
                  "trial_days": {
                    "type": "integer",
                    "description": "D\u00edas de prueba (0\u2013730); por defecto los del precio."
                  },
                  "success_url": {
                    "type": "string",
                    "description": "A d\u00f3nde vuelve el cliente al terminar."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Activo (por defecto `true`)."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      },
      "get": {
        "operationId": "payment-links-list",
        "summary": "Listar enlaces de pago",
        "description": "Del m\u00e1s reciente al m\u00e1s antiguo.",
        "tags": [
          "payment_links"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Solo activos o inactivos.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "name": "price",
            "in": "query",
            "required": false,
            "description": "Solo de un precio.",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.payment_links.list",
        "x-plan-module": "checkout",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited"
        ]
      }
    },
    "/payment_links/{id}": {
      "get": {
        "operationId": "payment-links-retrieve",
        "summary": "Consultar un enlace de pago",
        "description": "Con cu\u00e1ntos checkouts abri\u00f3.",
        "tags": [
          "payment_links"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_link"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.payment_links.retrieve",
        "x-plan-module": "checkout",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "payment-links-update",
        "summary": "Actualizar un enlace de pago",
        "description": "Desact\u00edvalo (`active: false`) para que deje de abrir checkouts; el precio y las l\u00edneas no cambian: crea otro enlace.",
        "tags": [
          "payment_links"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/payment_link"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.payment_links.update",
        "x-plan-module": "checkout",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "active": {
                    "type": "boolean",
                    "description": "Activo."
                  },
                  "customer_fields": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "enum": [
                      "name",
                      "legal_id",
                      "phone"
                    ],
                    "description": "Datos a pedir adem\u00e1s del correo."
                  },
                  "trial_days": {
                    "type": "integer",
                    "description": "D\u00edas de prueba."
                  },
                  "success_url": {
                    "type": "string",
                    "description": "A d\u00f3nde vuelve el cliente al terminar."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/portal_sessions": {
      "post": {
        "operationId": "portal-sessions-create",
        "summary": "Crear una sesi\u00f3n del portal",
        "description": "Responde la `url` del portal del cliente (`portal.bucli.co/s/\u2026`), v\u00e1lida una hora: ah\u00ed ve sus suscripciones y su pr\u00f3ximo cobro, cancela al fin del periodo, cambia la tarjeta (si deb\u00eda, se cobra de inmediato), descarga sus recibos y edita sus datos, seg\u00fan lo que permitas en \u00abPortal y marca\u00bb. La `url` solo se responde al crearla: si la respuesta se perdi\u00f3 y repites la petici\u00f3n con la misma `Idempotency-Key`, responde `409 url_unavailable_on_replay` (con `error.object_id`); crea otra sesi\u00f3n con una clave nueva.",
        "tags": [
          "portal_sessions"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/portal.session"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.portal_sessions.create",
        "x-plan-module": "portal",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "url_unavailable_on_replay"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Cliente (`cus_\u2026`)."
                  },
                  "return_url": {
                    "type": "string",
                    "description": "A d\u00f3nde vuelve; por defecto la de \u00abPortal y marca\u00bb."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer"
                ]
              }
            }
          }
        }
      }
    },
    "/portal_sessions/{id}": {
      "get": {
        "operationId": "portal-sessions-retrieve",
        "summary": "Consultar una sesi\u00f3n del portal",
        "description": "Para qu\u00e9 cliente es y hasta cu\u00e1ndo vale, **sin la `url`** (`null`): su token es una credencial que solo se responde al crearla y que Bucli no guarda. Si la perdiste, crea otra sesi\u00f3n.",
        "tags": [
          "portal_sessions"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/portal.session"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "checkout.portal_sessions.retrieve",
        "x-plan-module": "portal",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/features": {
      "post": {
        "operationId": "features-create",
        "summary": "Crear un derecho",
        "description": "Una clave de tu vocabulario: un m\u00f3dulo (`boolean`) o un l\u00edmite (`limit`, `static` o `metered`). Bucli no conoce ninguna de antemano: tus productos dicen cu\u00e1les dan (`entitlements`).",
        "tags": [
          "features"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/feature"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.features.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_already_exists",
          "product_rules_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string",
                    "description": "Min\u00fasculas, n\u00fameros y `_`, empieza por letra (m\u00e1ximo 50). No cambia."
                  },
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "type": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "boolean",
                      "limit"
                    ],
                    "description": "`boolean` o `limit`."
                  },
                  "limit_kind": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "static",
                      "metered"
                    ],
                    "description": "De un l\u00edmite: `static` o `metered`."
                  },
                  "allows_unlimited": {
                    "type": "boolean",
                    "description": "De un l\u00edmite: `false` = nunca ilimitado (por defecto `true`)."
                  },
                  "description": {
                    "type": "string",
                    "description": "Descripci\u00f3n."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "key",
                  "name",
                  "type"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "features-list",
        "summary": "Listar los derechos",
        "description": "Tu vocabulario, por clave.",
        "tags": [
          "features"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "type",
            "in": "query",
            "required": false,
            "description": "Solo m\u00f3dulos o solo l\u00edmites.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "boolean",
                "limit"
              ]
            }
          },
          {
            "name": "key",
            "in": "query",
            "required": false,
            "description": "Clave exacta.",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.features.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/features/{id}": {
      "get": {
        "operationId": "features-retrieve",
        "summary": "Consultar un derecho",
        "description": "",
        "tags": [
          "features"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/feature"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.features.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "features-update",
        "summary": "Actualizar un derecho",
        "description": "El nombre, la descripci\u00f3n, la metadata y si un l\u00edmite admite ilimitado. La clave, el tipo y la clase no cambian. Apagar `allows_unlimited` con un producto que lo da ilimitado responde `400 limit_unlimited_not_allowed`.",
        "tags": [
          "features"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/feature"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.features.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "parameter_unknown",
          "limit_unlimited_not_allowed"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "description": {
                    "type": "string",
                    "description": "Descripci\u00f3n."
                  },
                  "allows_unlimited": {
                    "type": "boolean",
                    "description": "Solo de un l\u00edmite."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      },
      "delete": {
        "operationId": "features-delete",
        "summary": "Eliminar un derecho",
        "description": "Solo uno que nada usa: ni un producto, ni un ajuste, ni un medidor (`422 feature_in_use`).",
        "tags": [
          "features"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Deleted"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.features.destroy",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "feature_in_use"
        ]
      }
    },
    "/subscriptions/{id}/entitlements": {
      "get": {
        "operationId": "subscriptions-entitlements",
        "summary": "Consultar los derechos de una suscripci\u00f3n",
        "description": "Lo que dan sus productos combinados (m\u00f3dulos unidos, l\u00edmites sumados, la cantidad multiplica los de un producto por unidades, `-1` gana), con tus ajustes encima, y el acceso que su estado da: `full` en prueba o activa (y con pago atrasado durante tus d\u00edas de gracia), `read_only` pausada, cancelada o pasada la gracia (con `read_only_reason`), `none` si nunca se pag\u00f3. Cada cambio llega como `entitlements.updated`.",
        "tags": [
          "entitlements"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/entitlements"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.entitlements.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/subscriptions/{id}/entitlement_overrides": {
      "post": {
        "operationId": "subscriptions-entitlement-overrides",
        "summary": "Ajustar los derechos de una suscripci\u00f3n",
        "description": "Tus ajustes a mano, completos (lo que no env\u00edes se quita; un cuerpo vac\u00edo los borra): `features_add`, `features_remove` (gana sobre el plan) y `limits` (un m\u00ednimo: se toma el mayor entre el plan y el ajuste; `-1` gana). Se conservan en cada rec\u00e1lculo. Si el cliente compra un producto que da un m\u00f3dulo que quitaste a mano, la compra levanta esa restricci\u00f3n. Con `keep_current: true` y `price` (el plan al que baja; sin \u00e9l, su `pending_price`) convierte en ajustes lo que hoy tiene de m\u00e1s sobre ese plan: \u00fasalo antes de bajarlo de plan para no quitarle nada. Responde sus derechos ya recalculados.",
        "tags": [
          "entitlements"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/entitlements"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.overrides.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "feature_unknown",
          "feature_type_mismatch",
          "limit_invalid",
          "limit_unlimited_not_allowed",
          "product_rules_invalid"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "features_add": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "M\u00f3dulos que se suman."
                  },
                  "features_remove": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "M\u00f3dulos que se quitan."
                  },
                  "limits": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "`{clave: n\u00famero}` m\u00ednimos; `-1` = ilimitado."
                  },
                  "note": {
                    "type": "string",
                    "description": "Por qu\u00e9 (hasta 500 caracteres)."
                  },
                  "keep_current": {
                    "type": "boolean",
                    "description": "Convertir lo que tiene de m\u00e1s en ajustes (con `price` y `note`)."
                  },
                  "price": {
                    "type": "string",
                    "description": "Con `keep_current`: el precio del plan al que baja (por defecto su `pending_price`)."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/customers/{id}/entitlements": {
      "get": {
        "operationId": "customers-entitlements",
        "summary": "Consultar los derechos de un cliente",
        "description": "Sus suscripciones con acceso completo combinadas (m\u00f3dulos unidos, l\u00edmites sumados); si no tiene ninguna, habla la m\u00e1s reciente en solo lectura; si no tiene suscripciones, `access: none`. Es lo que cuentan los medidores del cliente.",
        "tags": [
          "entitlements"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/entitlements"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.entitlements.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/meters": {
      "post": {
        "operationId": "meters-create",
        "summary": "Crear un medidor",
        "description": "Cuenta un l\u00edmite `metered` de tu vocabulario con la misma `key`: el cupo de cada ventana es ese l\u00edmite en los derechos del cliente (plan + bloques recurrentes); las bolsas cubren lo que pase de ah\u00ed.",
        "tags": [
          "meters"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/meter"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.meters.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "meter_feature_missing",
          "resource_already_exists",
          "product_rules_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "key": {
                    "type": "string",
                    "description": "Clave del l\u00edmite medido."
                  },
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "window": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "calendar_month",
                      "billing_period",
                      "subscription_lifetime"
                    ],
                    "description": "Por defecto `calendar_month`. No cambia."
                  },
                  "timezone": {
                    "type": "string",
                    "description": "Por defecto `America/Bogota`. No cambia."
                  },
                  "on_unavailable": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "allow",
                      "deny"
                    ],
                    "description": "Por defecto `deny`."
                  },
                  "threshold_percent": {
                    "type": "integer",
                    "description": "Aviso al (por defecto 80)."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Por defecto `true`."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "key",
                  "name"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "meters-list",
        "summary": "Listar medidores",
        "description": "",
        "tags": [
          "meters"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.meters.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited"
        ]
      }
    },
    "/meters/{id}": {
      "get": {
        "operationId": "meters-retrieve",
        "summary": "Consultar un medidor",
        "description": "`{id}` es el id (`mtr_\u2026`) o la clave (`documents`).",
        "tags": [
          "meters"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/meter"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.meters.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "meters-update",
        "summary": "Actualizar un medidor",
        "description": "El nombre, `on_unavailable`, el aviso, si est\u00e1 activo y la metadata. La clave, la ventana y la zona no cambian.",
        "tags": [
          "meters"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/meter"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.meters.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "parameter_unknown"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "on_unavailable": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "enum": [
                      "allow",
                      "deny"
                    ],
                    "description": "`allow` o `deny`."
                  },
                  "threshold_percent": {
                    "type": "integer",
                    "description": "Aviso al."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Activo."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/meters/{id}/summary": {
      "get": {
        "operationId": "meters-summary",
        "summary": "Consultar el uso de un cliente",
        "description": "La ventana en curso: cupo, usado, lo que queda y las bolsas vivas con su saldo y vencimiento. Es la pantalla \u00abUso\u00bb.",
        "tags": [
          "meters"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "customer",
            "in": "query",
            "required": true,
            "description": "Id del cliente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/meter_balance"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.meters.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_missing"
        ]
      }
    },
    "/meters/{id}/reserve": {
      "post": {
        "operationId": "meters-reserve",
        "summary": "Reservar unidades",
        "description": "Justo antes del acto que no se deshace (mandar un documento). Gasta primero el cupo de la ventana y luego la bolsa viva que vence primero; si no alcanza responde `402 quota_exhausted` con `allowance`, `used` y `grants_remaining` en el error. La misma `idempotency_key` devuelve la misma reserva (200; la primera vez 201) \u2014 usa el id de tu documento. Con `billable: false` se registra sin gastar cupo. Solo con acceso completo (`402 entitlement_access_denied`). Responde el consumo con `remaining`, el saldo que le queda: gu\u00e1rdalo para negar sin llamar cuando llegue a cero. Una llave ya devuelta (`/usage/{id}/release`) vuelve a tomar sus unidades: el mismo documento enviado otra vez tras un rechazo. Reservar, reportar y devolver siguen abiertos aunque tu plan de Bucli est\u00e9 en solo lectura: es el consumo de tus clientes.",
        "tags": [
          "usage"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/usage_record"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.usage.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "meter_inactive",
          "quota_exhausted",
          "entitlement_access_denied",
          "usage_idempotency_key_reused",
          "product_rules_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente."
                  },
                  "idempotency_key": {
                    "type": "string",
                    "description": "Tu llave \u00fanica por unidad (hasta 255)."
                  },
                  "quantity": {
                    "type": "integer",
                    "description": "Unidades (por defecto 1)."
                  },
                  "billable": {
                    "type": "boolean",
                    "description": "`false`: se registra sin gastar cupo."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer",
                  "idempotency_key"
                ]
              }
            }
          }
        }
      }
    },
    "/usage": {
      "post": {
        "operationId": "usage-create",
        "summary": "Reportar consumo tard\u00edo",
        "description": "Lo que tu librer\u00eda dej\u00f3 pasar mientras Bucli no respond\u00eda (`on_unavailable: allow`): se asienta en la ventana en que ocurri\u00f3 y nunca se niega; lo que pase de todo queda como `overage`. Idempotente por `idempotency_key`. `occurred_at` no puede ser futuro ni de hace m\u00e1s de 35 d\u00edas.",
        "tags": [
          "usage"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/usage_record"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.usage.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "usage_report_invalid",
          "usage_idempotency_key_reused",
          "product_rules_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "meter": {
                    "type": "string",
                    "description": "Id o clave del medidor."
                  },
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente."
                  },
                  "idempotency_key": {
                    "type": "string",
                    "description": "La misma llave que habr\u00edas usado al reservar."
                  },
                  "occurred_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Cu\u00e1ndo pas\u00f3."
                  },
                  "quantity": {
                    "type": "integer",
                    "description": "Unidades (por defecto 1)."
                  },
                  "billable": {
                    "type": "boolean",
                    "description": "`false`: sin gastar cupo."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "meter",
                  "customer",
                  "idempotency_key",
                  "occurred_at"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "usage-list",
        "summary": "Listar el consumo",
        "description": "Del m\u00e1s reciente al m\u00e1s antiguo.",
        "tags": [
          "usage"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "meter",
            "in": "query",
            "required": false,
            "description": "Clave del medidor.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "customer",
            "in": "query",
            "required": false,
            "description": "Id del cliente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.usage.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited"
        ]
      }
    },
    "/usage/{id}": {
      "get": {
        "operationId": "usage-retrieve",
        "summary": "Consultar un consumo",
        "description": "",
        "tags": [
          "usage"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/usage_record"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.usage.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/usage/{id}/release": {
      "post": {
        "operationId": "usage-release",
        "summary": "Devolver un consumo",
        "description": "Cada unidad vuelve a SU origen (el cupo de su ventana o la bolsa de la que sali\u00f3), una sola vez: una segunda llamada responde el consumo tal como est\u00e1. Para un documento rechazado, un borrador borrado o un env\u00edo que no sali\u00f3.",
        "tags": [
          "usage"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/usage_record"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.usage.release",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_unknown"
        ]
      }
    },
    "/grant_offers": {
      "post": {
        "operationId": "grant-offers-create",
        "summary": "Crear una oferta de bolsa",
        "description": "Un paquete de unidades que vendes (20, 100, 500\u2026), con un precio de pago \u00fanico (`type: one_time`) de un producto tuyo: as\u00ed la factura electr\u00f3nica usa su producto enlazado.",
        "tags": [
          "grant_offers"
        ],
        "parameters": [
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_offer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grant_offers.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "grant_offer_price_invalid",
          "feature_unknown",
          "feature_type_mismatch"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "meter": {
                    "type": "string",
                    "description": "Id o clave del medidor."
                  },
                  "price": {
                    "type": "string",
                    "description": "Precio de pago \u00fanico (`price_\u2026`)."
                  },
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "units": {
                    "type": "integer",
                    "description": "Unidades."
                  },
                  "validity_months": {
                    "type": "integer",
                    "description": "Vigencia desde el pago (por defecto 12; 0 = no vence)."
                  },
                  "requires_features": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "Solo para clientes con alguno de estos m\u00f3dulos."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Por defecto `true`."
                  },
                  "position": {
                    "type": "integer",
                    "description": "Orden."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "meter",
                  "price",
                  "name",
                  "units"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "grant-offers-list",
        "summary": "Listar las ofertas de bolsas",
        "description": "",
        "tags": [
          "grant_offers"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "meter",
            "in": "query",
            "required": false,
            "description": "Clave del medidor.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "active",
            "in": "query",
            "required": false,
            "description": "Activas o no.",
            "schema": {
              "type": "boolean"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grant_offers.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/grant_offers/{id}": {
      "get": {
        "operationId": "grant-offers-retrieve",
        "summary": "Consultar una oferta de bolsa",
        "description": "",
        "tags": [
          "grant_offers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_offer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grant_offers.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      },
      "patch": {
        "operationId": "grant-offers-update",
        "summary": "Actualizar una oferta de bolsa",
        "description": "El nombre, los m\u00f3dulos que exige, el orden, si est\u00e1 activa y la metadata. Unidades, precio y vigencia no cambian: crea otra oferta.",
        "tags": [
          "grant_offers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant_offer"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grant_offers.update",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "parameter_invalid",
          "parameter_unknown",
          "feature_unknown"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "name": {
                    "type": "string",
                    "description": "Nombre."
                  },
                  "requires_features": {
                    "type": "array",
                    "items": {
                      "type": "string"
                    },
                    "description": "M\u00f3dulos que exige."
                  },
                  "active": {
                    "type": "boolean",
                    "description": "Archivar o reactivar."
                  },
                  "position": {
                    "type": "integer",
                    "description": "Orden."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    },
    "/grant_offers/{id}/purchase": {
      "post": {
        "operationId": "grant-offers-purchase",
        "summary": "Vender una bolsa",
        "description": "Crea una factura \u00fanica con el precio de la oferta y la cobra a la tarjeta del cliente por el mismo camino de todo cobro (Wompi confirma antes de aprobar). Responde la factura; la bolsa queda vigente cuando se aprueba (`invoice.paid` y luego `grant.created`), con su vencimiento contado desde el pago. Si la factura se anula, la bolsa no nace. Exige la cabecera `Idempotency-Key` (cobra una tarjeta: un reintento sin ella cobrar\u00eda dos veces).",
        "tags": [
          "grant_offers"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/invoice"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grant_offers.purchase",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "resource_missing",
          "grant_offer_unavailable",
          "grant_offer_requires_feature",
          "customer_payment_method_missing",
          "payment_method_unavailable",
          "invoice_amount_too_small"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente."
                  },
                  "payment_method": {
                    "type": "string",
                    "description": "Tarjeta del cliente (por defecto, la predeterminada)."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer"
                ]
              }
            }
          }
        }
      }
    },
    "/grants": {
      "post": {
        "operationId": "grants-create",
        "summary": "Regalar una bolsa",
        "description": "Unidades que das a un cliente (o que importas de tu sistema anterior con `imported: true` y lo que le queda en `remaining`). Emite `grant.created`.",
        "tags": [
          "grants"
        ],
        "parameters": [
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grants.create",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_missing",
          "parameter_invalid",
          "resource_missing",
          "product_rules_invalid"
        ],
        "requestBody": {
          "required": true,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "customer": {
                    "type": "string",
                    "description": "Id del cliente."
                  },
                  "meter": {
                    "type": "string",
                    "description": "Id o clave del medidor."
                  },
                  "units": {
                    "type": "integer",
                    "description": "Unidades."
                  },
                  "remaining": {
                    "type": "integer",
                    "description": "Lo que le queda (por defecto todas)."
                  },
                  "expires_at": {
                    "type": [
                      "string",
                      "null"
                    ],
                    "format": "date-time",
                    "description": "Vencimiento (futuro); sin \u00e9l no vence."
                  },
                  "note": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  },
                  "imported": {
                    "type": "boolean",
                    "description": "Viene de tu sistema anterior."
                  },
                  "metadata": {
                    "type": [
                      "object",
                      "null"
                    ],
                    "description": "Hasta 20 pares de texto (claves \u2264 40, valores \u2264 500). En un PATCH se combinan; `\"\"` borra una clave."
                  }
                },
                "additionalProperties": false,
                "required": [
                  "customer",
                  "meter",
                  "units"
                ]
              }
            }
          }
        }
      },
      "get": {
        "operationId": "grants-list",
        "summary": "Listar las bolsas",
        "description": "",
        "tags": [
          "grants"
        ],
        "parameters": [
          {
            "name": "limit",
            "in": "query",
            "required": false,
            "description": "Cu\u00e1ntos objetos, de 1 a 100 (por defecto 10).",
            "schema": {
              "type": "integer"
            }
          },
          {
            "name": "starting_after",
            "in": "query",
            "required": false,
            "description": "Id del \u00faltimo objeto de la p\u00e1gina anterior: trae la siguiente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "ending_before",
            "in": "query",
            "required": false,
            "description": "Id del primer objeto de la p\u00e1gina actual: trae la anterior.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan m\u00e1s en el l\u00edmite de uso.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "name": "customer",
            "in": "query",
            "required": false,
            "description": "Id del cliente.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "meter",
            "in": "query",
            "required": false,
            "description": "Clave del medidor.",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "status",
            "in": "query",
            "required": false,
            "description": "Estado.",
            "schema": {
              "type": [
                "string",
                "null"
              ],
              "enum": [
                "pending",
                "active",
                "expired",
                "withdrawn",
                "canceled"
              ]
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/List"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grants.list",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "parameter_invalid"
        ]
      }
    },
    "/grants/{id}": {
      "get": {
        "operationId": "grants-retrieve",
        "summary": "Consultar una bolsa",
        "description": "",
        "tags": [
          "grants"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "name": "expand[]",
            "in": "query",
            "required": false,
            "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
            "schema": {
              "type": "array",
              "items": {
                "type": "string"
              }
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grants.retrieve",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing"
        ]
      }
    },
    "/grants/{id}/withdraw": {
      "post": {
        "operationId": "grants-withdraw",
        "summary": "Retirar una bolsa",
        "description": "Le quita lo que le queda a una bolsa vigente (un reembolso total, un error). Emite `grant.withdrawn`.",
        "tags": [
          "grants"
        ],
        "parameters": [
          {
            "name": "id",
            "in": "path",
            "required": true,
            "description": "Id del objeto (`cus_\u2026`, `sub_\u2026`).",
            "schema": {
              "type": "string"
            }
          },
          {
            "$ref": "#/components/parameters/Version"
          },
          {
            "$ref": "#/components/parameters/IdempotencyKey"
          }
        ],
        "responses": {
          "200": {
            "description": "OK",
            "headers": {
              "Request-Id": {
                "schema": {
                  "type": "string"
                }
              }
            },
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/grant"
                }
              }
            }
          },
          "default": {
            "description": "Error",
            "content": {
              "application/json": {
                "schema": {
                  "$ref": "#/components/schemas/Error"
                }
              }
            }
          }
        },
        "x-permission": "entitlements.grants.withdraw",
        "x-plan-module": "api",
        "x-error-codes": [
          "api_key_invalid",
          "rate_limited",
          "resource_missing",
          "grant_not_withdrawable"
        ],
        "requestBody": {
          "required": false,
          "content": {
            "application/json": {
              "schema": {
                "type": "object",
                "properties": {
                  "note": {
                    "type": "string",
                    "description": "Por qu\u00e9."
                  }
                },
                "additionalProperties": false
              }
            }
          }
        }
      }
    }
  },
  "components": {
    "securitySchemes": {
      "SecretKey": {
        "type": "http",
        "scheme": "bearer",
        "bearerFormat": "sk_test_\u2026 / sk_live_\u2026",
        "description": "Llave secreta de Desarrolladores \u2192 Llaves. La llave decide el modo."
      }
    },
    "parameters": {
      "IdempotencyKey": {
        "name": "Idempotency-Key",
        "in": "header",
        "required": false,
        "description": "Clave \u00fanica por operaci\u00f3n: un reintento con la misma clave repite la respuesta (24 h); con otro cuerpo responde 409.",
        "schema": {
          "type": "string",
          "maxLength": 255
        }
      },
      "Version": {
        "name": "Bucli-Version",
        "in": "header",
        "required": false,
        "description": "Versi\u00f3n de la API (por defecto, la fijada a tu cuenta).",
        "schema": {
          "type": "string",
          "example": "2026-11-01"
        }
      },
      "Mode": {
        "name": "Bucli-Mode",
        "in": "header",
        "required": false,
        "description": "Solo con la sesi\u00f3n del dashboard: test o live.",
        "schema": {
          "type": "string",
          "enum": [
            "test",
            "live"
          ]
        }
      }
    },
    "schemas": {
      "customer": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`cus_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`customer`"
          },
          "external_id": {
            "type": "string",
            "description": "Tu id del cliente (`org-\u2026`): \u00fanico por cuenta y modo; `null` si no tiene. Con \u00e9l, el correo puede repetirse (las empresas de un mismo due\u00f1o)."
          },
          "email": {
            "type": "string",
            "description": "Correo; \u00fanico por cuenta y modo entre los clientes sin `external_id`."
          },
          "name": {
            "type": "string",
            "description": "Nombre."
          },
          "phone": {
            "type": "string",
            "description": "Celular."
          },
          "legal_id_type": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo de documento: CC, CE, NIT, PP, TI, PPT."
          },
          "legal_id": {
            "type": "string",
            "description": "N\u00famero de documento."
          },
          "fiscal": {
            "type": [
              "object",
              "null"
            ],
            "description": "Datos fiscales para la factura electr\u00f3nica (integraci\u00f3n con Klopi), o `null`: `party_type` (`company` \u00b7 `person`), `document_type` (`nit`, `cc`, `ce`, `pa`, `ti`, `rc`, `de`, `pep`, `ppt`, `te`, `nit_ext`, `nuip`), `document_number`, `verification_digit` (del NIT), `business_name` (raz\u00f3n social) o `first_name` y `last_name`, `email` (adonde llega la factura; si falta, el `email` del cliente), `address`, `country_code` (ISO-2, `CO` por defecto), `city_code` (DANE, en Colombia) o `city_name` (fuera de Colombia), `department`, `tax_regime` (`ordinary` \u00b7 `simple`), `is_vat_responsible`, `is_great_contributor` (O-13), `is_self_withholder` (O-15), `rut_responsibilities` (otras, como `O-23`), `final_consumer`, `complete` (alcanza para facturar) y `source` (de d\u00f3nde vienen: `api`, `import`, `checkout`, `portal` o `dashboard`)."
          },
          "default_payment_method": {
            "type": "string",
            "description": "M\u00e9todo de pago predeterminado (expandible)."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "external_id",
          "email",
          "name",
          "phone",
          "legal_id_type",
          "legal_id",
          "fiscal",
          "default_payment_method",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "product": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`prod_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`product`"
          },
          "key": {
            "type": "string",
            "description": "Tu c\u00f3digo del producto (\u00abpro\u00bb, \u00abusuario-adicional\u00bb): \u00fanico por modo; `null` si no tiene."
          },
          "name": {
            "type": "string",
            "description": "Nombre del plan (\u00abPlan Gold\u00bb)."
          },
          "description": {
            "type": "string",
            "description": "Descripci\u00f3n."
          },
          "active": {
            "type": "boolean",
            "description": "`false`: archivado, no admite precios nuevos."
          },
          "entitlements": {
            "type": [
              "object",
              "null"
            ],
            "description": "Lo que da: `features` (claves de m\u00f3dulos de tu vocabulario, `/features`) y `limits` (`{clave: n\u00famero}`, `-1` = ilimitado). Los derechos de una suscripci\u00f3n son los de sus productos combinados."
          },
          "is_addon": {
            "type": "boolean",
            "description": "Es un adicional (se vende sobre un plan base)."
          },
          "is_trial": {
            "type": "boolean",
            "description": "Es tu producto de prueba: sus precios son de $0 con d\u00edas de prueba, y una suscripci\u00f3n solo con \u00e9l termina (`trial_ended`) al vencer la prueba, sin cobrar."
          },
          "kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qu\u00e9 es, le\u00eddo de sus reglas y sus precios: `plan` (de \u00e9l se hace una suscripci\u00f3n), `addon` (`is_addon`), `one_time` (todos sus precios son de pago \u00fanico: un paquete) o `trial` (`is_trial`)."
          },
          "active_prices": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Sus precios activos, del m\u00e1s barato al m\u00e1s caro (hasta 20): `{id, type, amount, currency, interval, interval_count, trial_days, nickname}`. Lo que una lista muestra de cu\u00e1nto cuesta; el precio completo es `GET /prices/{id}`."
          },
          "supports_quantity": {
            "type": "boolean",
            "description": "Se vende por unidades: sus l\u00edmites se multiplican por la cantidad. `false`: la cantidad es 1."
          },
          "addon_rules": {
            "type": [
              "object",
              "null"
            ],
            "description": "Reglas de venta de un adicional: `requires_features` (m\u00f3dulos que la suscripci\u00f3n ya debe tener), `allowed_base_products` (solo sobre estos planes), `skip_if_included` (no se vende si el plan ya da todos sus m\u00f3dulos) y `allowed_during_trial`."
          },
          "prorate_limits_on_add": {
            "type": "boolean",
            "description": "Agregado a mitad de ventana, sus cupos medidos dan la parte proporcional de los d\u00edas que quedan."
          },
          "meter_window": {
            "type": [
              "string",
              "null"
            ],
            "description": "Mientras es el plan base de la suscripci\u00f3n, la ventana en que cuentan los medidores (`subscription_lifetime` para una prueba o un plazo fijo); `null` = la de cada medidor."
          },
          "availability": {
            "type": [
              "string",
              "null"
            ],
            "description": "`public` (a la venta), `coming_soon` (se lista apagado, no se vende) o `internal` (nunca se lista ni se vende)."
          },
          "availability_note": {
            "type": "string",
            "description": "Nota de la disponibilidad (\u00abllega en enero\u00bb)."
          },
          "storefront": {
            "type": [
              "object",
              "null"
            ],
            "description": "Para dibujar tu p\u00e1gina de planes: `marketing_features`, `position`, `featured`, `visible_in_pricing`, `placement` (`main`: una tarjeta entre los planes principales; `secondary`: se vende, pero como una l\u00ednea bajo ellos), `icon` y `group` (libre: `module`, `seats`, `units`\u2026)."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "key",
          "name",
          "description",
          "active",
          "entitlements",
          "is_addon",
          "is_trial",
          "kind",
          "active_prices",
          "supports_quantity",
          "addon_rules",
          "prorate_limits_on_add",
          "meter_window",
          "availability",
          "availability_note",
          "storefront",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "feature": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`feat_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`feature`"
          },
          "key": {
            "type": "string",
            "description": "Tu clave (`einvoicing`, `users`): min\u00fasculas, n\u00fameros y `_`. No cambia."
          },
          "name": {
            "type": "string",
            "description": "Nombre."
          },
          "description": {
            "type": "string",
            "description": "Descripci\u00f3n."
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "`boolean` (un m\u00f3dulo) o `limit` (un n\u00famero)."
          },
          "limit_kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "De un l\u00edmite: `static` (cu\u00e1ntos a la vez: usuarios, GB; lo cuentas t\u00fa) o `metered` (cupo por ventana que cuenta el medidor con la misma clave). `null` en un m\u00f3dulo."
          },
          "allows_unlimited": {
            "type": "boolean",
            "description": "De un l\u00edmite: `false` = nunca es ilimitado (-1). `null` en un m\u00f3dulo."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "key",
          "name",
          "description",
          "type",
          "limit_kind",
          "allows_unlimited",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "entitlements": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "description": "`entitlements`"
          },
          "subscription": {
            "type": "string",
            "description": "Suscripci\u00f3n (expandible). En los de un cliente, la \u00fanica que habla por \u00e9l, o `null` si se combinan varias."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado de la suscripci\u00f3n (`null` si se combinan varias)."
          },
          "features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "M\u00f3dulos que tiene, ya con tus ajustes."
          },
          "limits": {
            "type": [
              "object",
              "null"
            ],
            "description": "`{clave: n\u00famero}`, ya con tus ajustes; `-1` = ilimitado."
          },
          "products": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`[{product, key, name, group, is_addon, quantity}]`: los productos que los dan (el plan base es el que no es adicional)."
          },
          "access": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qu\u00e9 puede hacer el cliente: full, read_only, none."
          },
          "read_only_reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Por qu\u00e9 est\u00e1 en solo lectura: trial_ended, canceled, payment_overdue, fixed_term_ended, paused. `null` con acceso completo."
          },
          "period_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin del periodo en curso."
          },
          "trial_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin de la prueba, si est\u00e1 en prueba."
          },
          "overrides": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus ajustes a mano: `features_add`, `features_remove`, `limits` (m\u00ednimos), `note`, `set_by`, `set_at`; `null` si no hay."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo cambiaron por \u00faltima vez."
          }
        },
        "required": [
          "object",
          "subscription",
          "customer",
          "status",
          "features",
          "limits",
          "products",
          "access",
          "read_only_reason",
          "period_end",
          "trial_end",
          "overrides",
          "livemode",
          "updated"
        ]
      },
      "meter": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`mtr_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`meter`"
          },
          "key": {
            "type": "string",
            "description": "La clave del l\u00edmite medido que cuenta (la misma de `/features`). En las rutas sirve de id."
          },
          "name": {
            "type": "string",
            "description": "Nombre."
          },
          "window": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cu\u00e1ndo se reinicia el cupo: `calendar_month` (el mes en su zona horaria, tambi\u00e9n en planes anuales), `billing_period` (el periodo de la suscripci\u00f3n) o `subscription_lifetime` (toda la suscripci\u00f3n: una prueba, un plazo fijo)."
          },
          "timezone": {
            "type": "string",
            "description": "Zona horaria de la ventana (`America/Bogota`)."
          },
          "on_unavailable": {
            "type": [
              "string",
              "null"
            ],
            "description": "Qu\u00e9 hace tu librer\u00eda si Bucli no responde: `allow` (deja pasar la unidad y la reporta despu\u00e9s con `POST /usage`) o `deny`."
          },
          "threshold_percent": {
            "type": "integer",
            "description": "Porcentaje del cupo que dispara `meter.threshold_reached`."
          },
          "active": {
            "type": "boolean",
            "description": "`false`: no admite reservas."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "key",
          "name",
          "window",
          "timezone",
          "on_unavailable",
          "threshold_percent",
          "active",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "grant_offer": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`goff_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`grant_offer`"
          },
          "meter": {
            "type": "string",
            "description": "Clave del medidor."
          },
          "price": {
            "type": "string",
            "description": "Precio de pago \u00fanico con que se cobra (expandible)."
          },
          "amount": {
            "type": "integer",
            "description": "Lo que cuesta (el del precio)."
          },
          "currency": {
            "type": "string",
            "description": "`COP` o `USD`: la del precio."
          },
          "name": {
            "type": "string",
            "description": "Nombre (\u00ab100 documentos\u00bb)."
          },
          "units": {
            "type": "integer",
            "description": "Unidades que da."
          },
          "validity_months": {
            "type": "integer",
            "description": "Meses de vigencia desde el pago; `null` = no vence."
          },
          "requires_features": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Solo se vende a un cliente que tenga alguno de estos m\u00f3dulos."
          },
          "active": {
            "type": "boolean",
            "description": "`false`: archivada, no se vende."
          },
          "position": {
            "type": "integer",
            "description": "Orden en tu vitrina."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "meter",
          "price",
          "amount",
          "currency",
          "name",
          "units",
          "validity_months",
          "requires_features",
          "active",
          "position",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "grant": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`grt_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`grant`"
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "meter": {
            "type": "string",
            "description": "Clave del medidor."
          },
          "offer": {
            "type": "string",
            "description": "Oferta que se compr\u00f3 (`goff_\u2026`); `null` si fue un regalo o se import\u00f3."
          },
          "invoice": {
            "type": "string",
            "description": "Factura que la pag\u00f3 (expandible)."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "`purchase`, `staff` o `import`."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado: pending, active, expired, withdrawn, canceled."
          },
          "units": {
            "type": "integer",
            "description": "Unidades que dio."
          },
          "remaining": {
            "type": "integer",
            "description": "Lo que le queda."
          },
          "expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo vence; `null` = no vence."
          },
          "ended_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo venci\u00f3, se retir\u00f3 o se anul\u00f3."
          },
          "note": {
            "type": "string",
            "description": "Nota."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "customer",
          "meter",
          "offer",
          "invoice",
          "source",
          "status",
          "units",
          "remaining",
          "expires_at",
          "ended_at",
          "note",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "usage_record": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`usg_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`usage_record`"
          },
          "meter": {
            "type": "string",
            "description": "Clave del medidor."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "quantity": {
            "type": "integer",
            "description": "Unidades."
          },
          "billable": {
            "type": "boolean",
            "description": "`false`: se registr\u00f3 sin gastar cupo."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "De d\u00f3nde sali\u00f3: `allowance` (el cupo de la ventana), `grant` (una bolsa), `overage` (excedente: cobrado con la tarifa del plan, o un reporte tard\u00edo por encima de todo), `unbilled` o `mixed`."
          },
          "grant": {
            "type": "string",
            "description": "La bolsa, si sali\u00f3 de una sola (`grt_\u2026`)."
          },
          "allocations": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`[{source, units, grant}]`: cada parte, para devolverla a su origen. Una parte `overage` con tarifa trae adem\u00e1s `unit_amount` y `per_units`."
          },
          "remaining": {
            "type": "integer",
            "description": "Lo que le queda al cliente tras esta reserva (cupo + bolsas; `-1` ilimitado)."
          },
          "idempotency_key": {
            "type": "string",
            "description": "Tu llave: la misma devuelve la misma reserva."
          },
          "reported": {
            "type": "boolean",
            "description": "Se report\u00f3 despu\u00e9s (`POST /usage`), no se reserv\u00f3."
          },
          "window_start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio de la ventana en que cuenta."
          },
          "occurred_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo ocurri\u00f3."
          },
          "released_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se devolvi\u00f3; `null` si no."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          }
        },
        "required": [
          "id",
          "object",
          "meter",
          "customer",
          "quantity",
          "billable",
          "source",
          "grant",
          "allocations",
          "remaining",
          "idempotency_key",
          "reported",
          "window_start",
          "occurred_at",
          "released_at",
          "metadata",
          "livemode",
          "created"
        ]
      },
      "meter_balance": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "description": "`meter_balance`"
          },
          "meter": {
            "type": "string",
            "description": "Clave del medidor."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "window_start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio de la ventana."
          },
          "window_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin de la ventana (`null` en una de toda la suscripci\u00f3n)."
          },
          "allowance": {
            "type": "integer",
            "description": "Cupo de la ventana (plan + bloques prorrateados; `-1` ilimitado)."
          },
          "used": {
            "type": "integer",
            "description": "Usado del cupo."
          },
          "allowance_remaining": {
            "type": "integer",
            "description": "Lo que queda del cupo (`-1` ilimitado)."
          },
          "grants": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Bolsas vivas: `[{id, remaining, units, expires_at}]`, la que vence primero primero."
          },
          "grants_remaining": {
            "type": "integer",
            "description": "Saldo de las bolsas vivas."
          },
          "remaining": {
            "type": "integer",
            "description": "Lo que puede gastar: cupo + bolsas (`-1` ilimitado)."
          },
          "overage": {
            "type": "integer",
            "description": "Unidades por encima del cupo y las bolsas: el excedente cobrado (si el precio tiene tarifa) y lo reportado tarde."
          },
          "overage_amount": {
            "type": "integer",
            "description": "Lo que cuesta el excedente de la ventana (en la moneda del precio)."
          },
          "overage_billed_amount": {
            "type": "integer",
            "description": "Lo que de eso ya se cobr\u00f3 en una renovaci\u00f3n."
          },
          "overage_rate": {
            "type": [
              "object",
              "null"
            ],
            "description": "`{unit_amount, per_units}` del plan del cliente, o `null` (sin excedente)."
          },
          "overage_cap": {
            "type": "integer",
            "description": "El tope del cliente por ventana, o `null` (sin excedente)."
          },
          "unbilled": {
            "type": "integer",
            "description": "Registrado sin gastar cupo (`billable: false`)."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo movimiento."
          }
        },
        "required": [
          "object",
          "meter",
          "customer",
          "window_start",
          "window_end",
          "allowance",
          "used",
          "allowance_remaining",
          "grants",
          "grants_remaining",
          "remaining",
          "overage",
          "overage_amount",
          "overage_billed_amount",
          "overage_rate",
          "overage_cap",
          "unbilled",
          "livemode",
          "updated"
        ]
      },
      "price": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`price_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`price`"
          },
          "product": {
            "type": "string",
            "description": "Producto (expandible)."
          },
          "nickname": {
            "type": "string",
            "description": "Nombre interno."
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "`recurring` (se cobra cada ciclo: suscripciones) o `one_time` (pago \u00fanico: facturas \u00fanicas, paquetes)."
          },
          "amount": {
            "type": "integer",
            "description": "En la unidad de la moneda: pesos enteros (`89900` = $89.900) o centavos de d\u00f3lar (`2900` = US$29)."
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "description": "`COP` o `USD`. Wompi cobra en pesos: un precio en d\u00f3lares se convierte en cada cobro con la TRM vigente."
          },
          "interval": {
            "type": [
              "string",
              "null"
            ],
            "description": "Cada cu\u00e1nto: day, week, month, year. `null` en un pago \u00fanico."
          },
          "interval_count": {
            "type": "integer",
            "description": "Cu\u00e1ntos intervalos por ciclo (1\u201336). `null` en un pago \u00fanico."
          },
          "trial_days": {
            "type": "integer",
            "description": "D\u00edas de prueba gratis (0 en un pago \u00fanico)."
          },
          "recurring": {
            "type": [
              "object",
              "null"
            ],
            "description": "`interval`, `interval_count` y `trial_days` de un precio recurrente; `null` si es \u00fanico."
          },
          "metered_rates": {
            "type": [
              "object",
              "null"
            ],
            "description": "`{clave_del_medidor: {unit_amount, per_units}}`: el excedente de cada l\u00edmite medido. `{}` = sin excedente."
          },
          "active": {
            "type": "boolean",
            "description": "`false`: archivado, no admite suscripciones nuevas."
          },
          "in_use": {
            "type": "boolean",
            "description": "Si ya lo usa algo: una suscripci\u00f3n (o un cambio que espera la renovaci\u00f3n), una factura, un enlace de pago, una sesi\u00f3n de checkout, un paquete o un plazo fijo. Mientras sea `false`, sus t\u00e9rminos se pueden corregir con `PATCH`; despu\u00e9s ya no cambian."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "product",
          "nickname",
          "type",
          "amount",
          "currency",
          "interval",
          "interval_count",
          "trial_days",
          "recurring",
          "metered_rates",
          "active",
          "in_use",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "payment_method": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`pm_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`payment_method`"
          },
          "type": {
            "type": [
              "string",
              "null"
            ],
            "description": "`card` o `nequi`."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado: pending, available, failed, detached, suspended."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible); `null` si se quit\u00f3."
          },
          "is_default": {
            "type": "boolean",
            "description": "Si es el predeterminado del cliente."
          },
          "is_backup": {
            "type": "boolean",
            "description": "Si es la de respaldo: se intenta enseguida cuando la predeterminada rechaza."
          },
          "suspended": {
            "type": [
              "object",
              "null"
            ],
            "description": "`{at, reason}` de un rechazo duro (robada, perdida, vencida\u2026): no se vuelve a cobrar. `null` si no."
          },
          "card": {
            "type": [
              "object",
              "null"
            ],
            "description": "`brand`, `last4`, `exp_month`, `exp_year` (solo tarjetas)."
          },
          "nequi": {
            "type": [
              "object",
              "null"
            ],
            "description": "`phone_last4` (solo Nequi)."
          },
          "imported": {
            "type": [
              "object",
              "null"
            ],
            "description": "`at` y `wompi_payment_source_id` si se import\u00f3 de tu cuenta de Wompi (`POST /payment_methods`); `null` si el cliente la guard\u00f3 en el checkout o el portal."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "type",
          "status",
          "customer",
          "is_default",
          "is_backup",
          "suspended",
          "card",
          "nequi",
          "imported",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "subscription": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`sub_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`subscription`"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado: incomplete, incomplete_expired, trialing, active, past_due, canceled, paused."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "price": {
            "type": "string",
            "description": "Precio del primer \u00edtem (expandible). Se conserva por compatibilidad: lo nuevo es `items`."
          },
          "items": {
            "type": [
              "object",
              "null"
            ],
            "description": "Lista (`{object: list, data, has_more, url}`) de los \u00edtems de la suscripci\u00f3n: plan base, puestos adicionales y dem\u00e1s, cada uno `subscription_item` con su precio completo y su `quantity`. Siempre al menos uno. Cada periodo se factura la suma de todos."
          },
          "billing_cycle_anchor": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Desde d\u00f3nde se cuentan los periodos (el inicio del primer periodo completo); `null` en suscripciones anteriores a este campo."
          },
          "pending_price": {
            "type": "string",
            "description": "Precio que aplica desde el pr\u00f3ximo ciclo (expandible)."
          },
          "default_payment_method": {
            "type": "string",
            "description": "M\u00e9todo con el que se cobra (expandible)."
          },
          "latest_invoice": {
            "type": "string",
            "description": "\u00daltima factura (expandible)."
          },
          "start_date": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio."
          },
          "current_period_start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio del periodo en curso."
          },
          "current_period_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin del periodo en curso."
          },
          "next_billing_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Pr\u00f3ximo cobro."
          },
          "trial_start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio de la prueba."
          },
          "trial_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin de la prueba."
          },
          "cancel_at_period_end": {
            "type": "boolean",
            "description": "Se cancelar\u00e1 al terminar el periodo."
          },
          "canceled_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se pidi\u00f3 la cancelaci\u00f3n."
          },
          "ended_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo termin\u00f3."
          },
          "cancellation_details": {
            "type": [
              "object",
              "null"
            ],
            "description": "`reason` y `comment` de la cancelaci\u00f3n."
          },
          "pending_update": {
            "type": [
              "object",
              "null"
            ],
            "description": "El `subscription_change` que espera su cobro, o `null`."
          },
          "discount": {
            "type": [
              "object",
              "null"
            ],
            "description": "El `discount` vigente (el cup\u00f3n aplicado), o `null`."
          },
          "pause_at_period_end": {
            "type": "boolean",
            "description": "`true`: al terminar el periodo pagado queda `paused` (ver \u00abPausar el cobro\u00bb)."
          },
          "paused_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Desde cu\u00e1ndo est\u00e1 pausada, o `null`."
          },
          "resumes_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se reanuda sola, o `null` (a mano)."
          },
          "fixed_term_ends_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Un plan por tiempo fijo: cu\u00e1ndo termina (no renueva ni tiene gracia); `null` en una suscripci\u00f3n normal."
          },
          "overage_caps": {
            "type": [
              "object",
              "null"
            ],
            "description": "`{clave_del_medidor: valor}`: el tope de excedente que fij\u00f3 el cliente; un medidor que no est\u00e9 vale lo que cuesta el plan."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio de la suscripci\u00f3n o de cualquiera de sus \u00edtems (ISO 8601, UTC, como `created`). Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "status",
          "customer",
          "price",
          "items",
          "billing_cycle_anchor",
          "pending_price",
          "default_payment_method",
          "latest_invoice",
          "start_date",
          "current_period_start",
          "current_period_end",
          "next_billing_at",
          "trial_start",
          "trial_end",
          "cancel_at_period_end",
          "canceled_at",
          "ended_at",
          "cancellation_details",
          "pending_update",
          "discount",
          "pause_at_period_end",
          "paused_at",
          "resumes_at",
          "fixed_term_ends_at",
          "overage_caps",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "invoice": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`in_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`invoice`"
          },
          "number": {
            "type": "string",
            "description": "Consecutivo de la cuenta."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado: draft, open, paid, void, uncollectible."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "subscription": {
            "type": "string",
            "description": "Suscripci\u00f3n (expandible)."
          },
          "price": {
            "type": "string",
            "description": "Precio de la primera l\u00ednea (expandible)."
          },
          "default_payment_method": {
            "type": "string",
            "description": "M\u00e9todo con que se cobra una factura \u00fanica (expandible); `null`: el de la suscripci\u00f3n o el predeterminado del cliente."
          },
          "amount": {
            "type": "integer",
            "description": "Lo que se cobra: `subtotal` \u2212 `discount_amount`, en la moneda de la factura."
          },
          "subtotal": {
            "type": "integer",
            "description": "La suma de las l\u00edneas a precio de lista."
          },
          "discount_amount": {
            "type": "integer",
            "description": "Lo que rebaj\u00f3 el cup\u00f3n (la suma de `discount_amount` de las l\u00edneas)."
          },
          "discount": {
            "type": "string",
            "description": "El `discount` que la rebaj\u00f3 (`di_\u2026`), o `null`."
          },
          "currency": {
            "type": [
              "string",
              "null"
            ],
            "description": "`COP` o `USD`: la de sus precios."
          },
          "charged_amount": {
            "type": "integer",
            "description": "Lo que Wompi cobr\u00f3, en pesos (al pagarse); `null` antes."
          },
          "exchange_rate": {
            "type": "string",
            "description": "Pesos por unidad de `currency` con que se cobr\u00f3 (`\"1\"` en pesos); `null` antes de pagarse."
          },
          "lines": {
            "type": [
              "object",
              "null"
            ],
            "description": "Lista (`{object: list, data, has_more, url}`) de las l\u00edneas `invoice_line`: un \u00edtem de la suscripci\u00f3n por periodo, un precio \u00fanico \u00d7 cantidad o un monto libre."
          },
          "retry": {
            "type": "boolean",
            "description": "Si un cobro rechazado se reintenta solo seg\u00fan tu calendario de reintentos. `true` en las facturas de suscripci\u00f3n; en una factura \u00fanica, lo que enviaste (por defecto `false`)."
          },
          "billing_reason": {
            "type": [
              "string",
              "null"
            ],
            "description": "Motivo: subscription_create, subscription_cycle, subscription_update, payment_link, manual, fixed_term."
          },
          "description": {
            "type": "string",
            "description": "Descripci\u00f3n."
          },
          "period_start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio del periodo facturado."
          },
          "period_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin del periodo facturado."
          },
          "attempt_count": {
            "type": "integer",
            "description": "Intentos de cobro hechos."
          },
          "next_payment_attempt": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Pr\u00f3ximo reintento."
          },
          "paid_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se pag\u00f3."
          },
          "voided_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se anul\u00f3."
          },
          "fiscal_document": {
            "type": [
              "object",
              "null"
            ],
            "description": "La factura electr\u00f3nica DIAN de una factura pagada, emitida con tu Klopi (Facturaci\u00f3n electr\u00f3nica): `status` (`queued` \u00b7 `emitting` \u00b7 `issued` \u00b7 `rejected` \u00b7 `failed` \u00b7 `skipped`), `number`, `cufe`, `pdf_url` y `dian_message` (el motivo de un rechazo). `null` si no tienes la facturaci\u00f3n electr\u00f3nica activa. En modo de pruebas es simulada: n\u00famero `PRUEBA-\u2026`, sin CUFE. El total de la factura electr\u00f3nica es exactamente `amount`: el precio incluye el IVA."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio de la factura, de sus l\u00edneas o de su factura electr\u00f3nica (ISO 8601, UTC, como `created`)."
          }
        },
        "required": [
          "id",
          "object",
          "number",
          "status",
          "customer",
          "subscription",
          "price",
          "default_payment_method",
          "amount",
          "subtotal",
          "discount_amount",
          "discount",
          "currency",
          "charged_amount",
          "exchange_rate",
          "lines",
          "retry",
          "billing_reason",
          "description",
          "period_start",
          "period_end",
          "attempt_count",
          "next_payment_attempt",
          "paid_at",
          "voided_at",
          "fiscal_document",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "subscription_item": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`si_\u2026` (`null` solo un momento despu\u00e9s de un despliegue, en una suscripci\u00f3n anterior)."
          },
          "object": {
            "type": "string",
            "description": "`subscription_item`"
          },
          "subscription": {
            "type": "string",
            "description": "Suscripci\u00f3n (expandible)."
          },
          "price": {
            "type": [
              "object",
              "null"
            ],
            "description": "El precio completo (recurrente, con el intervalo de la suscripci\u00f3n)."
          },
          "quantity": {
            "type": "integer",
            "description": "Cantidad (puestos, licencias): se cobra `price.amount \u00d7 quantity` cada periodo."
          },
          "scheduled_quantity": {
            "type": "integer",
            "description": "Cantidad desde la renovaci\u00f3n (un cambio con `create_prorations` que baja el valor); `0` = se quita. `null` = sin cambio."
          },
          "scheduled_price": {
            "type": "string",
            "description": "Precio desde la renovaci\u00f3n (`price_\u2026`), o `null`."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "subscription",
          "price",
          "quantity",
          "scheduled_quantity",
          "scheduled_price",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "subscription_change": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`sc_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`subscription_change`"
          },
          "subscription": {
            "type": "string",
            "description": "Suscripci\u00f3n (expandible)."
          },
          "invoice": {
            "type": "string",
            "description": "Factura que cobra el cambio (expandible)."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "`pending` (esperando el cobro), `applied` (pagado y aplicado) o `failed` (no se cobr\u00f3: nada cambi\u00f3)."
          },
          "amount": {
            "type": "integer",
            "description": "Lo que se cobra, en `currency`."
          },
          "currency": {
            "type": "string",
            "description": "La de la suscripci\u00f3n."
          },
          "quote": {
            "type": [
              "object",
              "null"
            ],
            "description": "La cotizaci\u00f3n cobrada, como la mostr\u00f3 la vista previa."
          },
          "applied_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se aplic\u00f3."
          },
          "failed_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo fall\u00f3."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Creado."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "subscription",
          "invoice",
          "status",
          "amount",
          "currency",
          "quote",
          "applied_at",
          "failed_at",
          "livemode",
          "created",
          "updated"
        ]
      },
      "subscription_quote": {
        "type": "object",
        "properties": {
          "object": {
            "type": "string",
            "description": "`subscription_quote`"
          },
          "subscription": {
            "type": "string",
            "description": "La suscripci\u00f3n (`sub_\u2026`)."
          },
          "direction": {
            "type": [
              "string",
              "null"
            ],
            "description": "`up`, `down` o `even`."
          },
          "applies": {
            "type": [
              "string",
              "null"
            ],
            "description": "`now` (al pagarse, o ya si es gratis) o `renewal`."
          },
          "amount": {
            "type": "integer",
            "description": "Lo que se cobra ahora, en `currency` (el `expected_amount` del cambio)."
          },
          "currency": {
            "type": "string",
            "description": "La de la suscripci\u00f3n."
          },
          "lines": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`[{description, amount}]`: lo que se cobra y los cr\u00e9ditos (negativos)."
          },
          "days_left": {
            "type": "integer",
            "description": "D\u00edas que quedan del periodo (hoy incluido)."
          },
          "period_days": {
            "type": "integer",
            "description": "D\u00edas del periodo."
          },
          "restarts_period": {
            "type": "boolean",
            "description": "`true`: un ciclo m\u00e1s largo empieza un periodo hoy."
          },
          "below_minimum": {
            "type": "boolean",
            "description": "`true`: bajo el m\u00ednimo de Wompi, aplica gratis."
          },
          "period_start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio del periodo despu\u00e9s del cambio."
          },
          "period_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin del periodo despu\u00e9s del cambio."
          },
          "total_before": {
            "type": "integer",
            "description": "Lo que cuesta cada periodo hoy."
          },
          "total_after": {
            "type": "integer",
            "description": "Lo que costar\u00e1 cada periodo despu\u00e9s del cambio."
          }
        },
        "required": [
          "object",
          "subscription",
          "direction",
          "applies",
          "amount",
          "currency",
          "lines",
          "days_left",
          "period_days",
          "restarts_period",
          "below_minimum",
          "period_start",
          "period_end",
          "total_before",
          "total_after"
        ]
      },
      "invoice_line": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`il_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`invoice_line`"
          },
          "invoice": {
            "type": "string",
            "description": "Factura (expandible)."
          },
          "description": {
            "type": "string",
            "description": "Qu\u00e9 se cobra (\u00abPuesto adicional \u00d7 3\u00bb)."
          },
          "price": {
            "type": [
              "object",
              "null"
            ],
            "description": "El precio completo, o `null` en un monto libre."
          },
          "subscription_item": {
            "type": "string",
            "description": "\u00cdtem de la suscripci\u00f3n que la origin\u00f3, o `null`."
          },
          "product": {
            "type": "string",
            "description": "El producto de la l\u00ednea (`prod_\u2026`), o `null` en un monto libre o un excedente."
          },
          "group": {
            "type": "string",
            "description": "El `group` del producto (para comisiones por plan y adicionales), o `null`."
          },
          "is_addon": {
            "type": "boolean",
            "description": "`true` si el producto es un adicional."
          },
          "quantity": {
            "type": "integer",
            "description": "Cantidad."
          },
          "unit_amount": {
            "type": "integer",
            "description": "Valor unitario, en la moneda de la factura."
          },
          "amount": {
            "type": "integer",
            "description": "`unit_amount \u00d7 quantity` (precio de lista)."
          },
          "discount_amount": {
            "type": "integer",
            "description": "Lo que el cup\u00f3n le rebaja a esta l\u00ednea."
          },
          "currency": {
            "type": "string",
            "description": "La de la factura."
          },
          "period_start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Inicio del periodo que cubre (`null` en un pago \u00fanico)."
          },
          "period_end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Fin del periodo que cubre."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          }
        },
        "required": [
          "id",
          "object",
          "invoice",
          "description",
          "price",
          "subscription_item",
          "product",
          "group",
          "is_addon",
          "quantity",
          "unit_amount",
          "amount",
          "discount_amount",
          "currency",
          "period_start",
          "period_end",
          "metadata",
          "livemode",
          "created"
        ]
      },
      "payment": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`py_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`payment`"
          },
          "invoice": {
            "type": "string",
            "description": "Factura (expandible)."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "payment_method": {
            "type": "string",
            "description": "M\u00e9todo cobrado (expandible)."
          },
          "attempt_number": {
            "type": "integer",
            "description": "N\u00famero del intento en la factura."
          },
          "reference": {
            "type": "string",
            "description": "Referencia enviada a Wompi (`inv_<id>_<n>`)."
          },
          "amount": {
            "type": "integer",
            "description": "Lo enviado a Wompi, en pesos enteros."
          },
          "currency": {
            "type": "string",
            "description": "`COP` (Wompi solo cobra pesos)."
          },
          "invoice_amount": {
            "type": "integer",
            "description": "El valor de la factura en su moneda cuando se cobr\u00f3."
          },
          "invoice_currency": {
            "type": "string",
            "description": "La moneda de la factura."
          },
          "exchange_rate": {
            "type": "string",
            "description": "Pesos por unidad de la moneda de la factura (la TRM usada); `null` en pesos."
          },
          "exchange_rate_date": {
            "type": "string",
            "description": "Desde cu\u00e1ndo rige esa tasa; `null` en pesos."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "Estado: pending, approved, declined, error, voided."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "`wompi` o `manual` (una transferencia registrada con `mark_paid`)."
          },
          "external_reference": {
            "type": "string",
            "description": "La referencia de un pago manual, o `null`."
          },
          "amount_refunded": {
            "type": "integer",
            "description": "Pesos devueltos (reembolsos y anulaciones)."
          },
          "refunded": {
            "type": "boolean",
            "description": "`true` cuando se devolvi\u00f3 todo."
          },
          "wompi_transaction_id": {
            "type": "string",
            "description": "Transacci\u00f3n en Wompi."
          },
          "failure_code": {
            "type": "string",
            "description": "C\u00f3digo del rechazo."
          },
          "failure_message": {
            "type": "string",
            "description": "Motivo del rechazo, en palabras del banco o de Wompi."
          },
          "sent_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se envi\u00f3 a Wompi."
          },
          "finalized_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se resolvi\u00f3."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3."
          }
        },
        "required": [
          "id",
          "object",
          "invoice",
          "customer",
          "payment_method",
          "attempt_number",
          "reference",
          "amount",
          "currency",
          "invoice_amount",
          "invoice_currency",
          "exchange_rate",
          "exchange_rate_date",
          "status",
          "source",
          "external_reference",
          "amount_refunded",
          "refunded",
          "wompi_transaction_id",
          "failure_code",
          "failure_message",
          "sent_at",
          "finalized_at",
          "livemode",
          "created"
        ]
      },
      "coupon": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`coupon_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`coupon`"
          },
          "name": {
            "type": "string",
            "description": "Nombre (se ve en la factura)."
          },
          "percent_off": {
            "type": "string",
            "description": "Porcentaje de descuento (`\"20\"`, `\"12.5\"`), o `null`."
          },
          "amount_off": {
            "type": "integer",
            "description": "Valor de descuento por periodo, en la unidad de `currency`, o `null`."
          },
          "currency": {
            "type": "string",
            "description": "La moneda de `amount_off`; `null` con `percent_off`."
          },
          "duration": {
            "type": [
              "string",
              "null"
            ],
            "description": "`once` (un periodo), `repeating` (N meses) o `forever`."
          },
          "duration_in_months": {
            "type": "integer",
            "description": "Con `repeating`: cu\u00e1ntos meses desde que se aplica."
          },
          "applies_to": {
            "type": [
              "string",
              "null"
            ],
            "description": "`all` (el plan y los adicionales), `plan` o `addons`."
          },
          "max_redemptions": {
            "type": "integer",
            "description": "A cu\u00e1ntas suscripciones se puede aplicar; `null` = sin tope."
          },
          "redeem_by": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Hasta cu\u00e1ndo se puede aplicar; `null` = sin fecha."
          },
          "times_redeemed": {
            "type": "integer",
            "description": "A cu\u00e1ntas suscripciones se aplic\u00f3. Desde la primera, sus t\u00e9rminos no cambian."
          },
          "active": {
            "type": "boolean",
            "description": "`false`: no se aplica a nadie m\u00e1s (los aplicados siguen)."
          },
          "valid": {
            "type": "boolean",
            "description": "Si se puede aplicar ahora (activo, sin vencer y con usos)."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "name",
          "percent_off",
          "amount_off",
          "currency",
          "duration",
          "duration_in_months",
          "applies_to",
          "max_redemptions",
          "redeem_by",
          "times_redeemed",
          "active",
          "valid",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "discount": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`di_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`discount`"
          },
          "subscription": {
            "type": "string",
            "description": "La suscripci\u00f3n (`sub_\u2026`)."
          },
          "coupon": {
            "type": [
              "object",
              "null"
            ],
            "description": "El cup\u00f3n completo."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "`active`, `ended` (se gast\u00f3) o `removed` (se quit\u00f3)."
          },
          "start": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Desde cu\u00e1ndo."
          },
          "end": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Con `repeating`: los periodos que empiezan desde aqu\u00ed ya no llevan descuento."
          },
          "ended_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo termin\u00f3 o se quit\u00f3."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se aplic\u00f3."
          }
        },
        "required": [
          "id",
          "object",
          "subscription",
          "coupon",
          "status",
          "start",
          "end",
          "ended_at",
          "livemode",
          "created"
        ]
      },
      "refund": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`re_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`refund`"
          },
          "payment": {
            "type": "string",
            "description": "El pago devuelto (expandible)."
          },
          "invoice": {
            "type": "string",
            "description": "Su factura (expandible)."
          },
          "subscription": {
            "type": "string",
            "description": "La suscripci\u00f3n de la factura, o `null`."
          },
          "kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "`void` (anulaci\u00f3n del cobro completo, el mismo d\u00eda) o `refund` (total o parcial)."
          },
          "source": {
            "type": [
              "string",
              "null"
            ],
            "description": "`bucli` (pedido aqu\u00ed), `external` (anulado desde el panel de Wompi) o `manual` (un pago manual devuelto por fuera: solo se registra)."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "`pending` (Wompi no ha respondido), `succeeded` o `failed`."
          },
          "amount": {
            "type": "integer",
            "description": "Pesos devueltos (Wompi devuelve en pesos)."
          },
          "currency": {
            "type": "string",
            "description": "`COP`."
          },
          "reason": {
            "type": "string",
            "description": "Motivo."
          },
          "requested_by": {
            "type": "string",
            "description": "Qui\u00e9n lo pidi\u00f3 (la llave o la persona)."
          },
          "cancel_subscription": {
            "type": "boolean",
            "description": "Si cancela la suscripci\u00f3n al quedar hecho (motivo `refunded`)."
          },
          "failure_message": {
            "type": "string",
            "description": "Por qu\u00e9 fall\u00f3, en palabras de Wompi."
          },
          "credit_note": {
            "type": [
              "object",
              "null"
            ],
            "description": "La nota cr\u00e9dito electr\u00f3nica en tu Klopi (`status`: `queued`, `draft` \u2014 un borrador que revisas y emites en Klopi \u2014, `issued`, `failed` o `skipped`; `number`; `error`), o `null` si la factura no ten\u00eda factura electr\u00f3nica."
          },
          "lines": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Las l\u00edneas `invoice_line` de la factura: lo que se hab\u00eda pagado."
          },
          "finalized_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se resolvi\u00f3."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se pidi\u00f3."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "payment",
          "invoice",
          "subscription",
          "kind",
          "source",
          "status",
          "amount",
          "currency",
          "reason",
          "requested_by",
          "cancel_subscription",
          "failure_message",
          "credit_note",
          "lines",
          "finalized_at",
          "livemode",
          "created",
          "updated"
        ]
      },
      "fixed_term_offer": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`fto_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`fixed_term_offer`"
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "name": {
            "type": "string",
            "description": "Nombre."
          },
          "items": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`[{price, quantity}]`."
          },
          "units": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "`[{meter, units}]`: unidades para todo el plazo."
          },
          "days": {
            "type": "integer",
            "description": "D\u00edas del plazo."
          },
          "amount": {
            "type": "integer",
            "description": "Precio en pesos."
          },
          "currency": {
            "type": "string",
            "description": "`COP`."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "`open` (esperando el pago), `paid`, `expired` o `canceled`."
          },
          "url": {
            "type": "string",
            "description": "El link de pago de Wompi."
          },
          "link_expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo vence el link."
          },
          "subscription": {
            "type": "string",
            "description": "La suscripci\u00f3n que empez\u00f3 al pagarse, o `null`."
          },
          "paid_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se pag\u00f3."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "customer",
          "name",
          "items",
          "units",
          "days",
          "amount",
          "currency",
          "status",
          "url",
          "link_expires_at",
          "subscription",
          "paid_at",
          "livemode",
          "created",
          "updated"
        ]
      },
      "notice": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`ntc_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`notice`"
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "subscription": {
            "type": "string",
            "description": "La suscripci\u00f3n de la que habla, o `null`."
          },
          "invoice": {
            "type": "string",
            "description": "La factura de la que habla, o `null`."
          },
          "kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "Tipo: receipt_activation, receipt_renewal, receipt_change, receipt_purchase, receipt_fixed_term, payment_failed, retries_exhausted, card_replace, payment_method_missing, card_expiring, renewal_upcoming, trial_ending, trial_ended, cancellation_scheduled, canceled, fixed_term_offer, fixed_term_ended."
          },
          "subject": {
            "type": "string",
            "description": "El asunto del correo."
          },
          "message": {
            "type": "string",
            "description": "El aviso en una frase (el de WhatsApp)."
          },
          "channels": {
            "type": [
              "object",
              "null"
            ],
            "description": "`{email, whatsapp}`: `sent`, `failed` o `skipped` (sin correo, sin celular\u2026)."
          },
          "sent_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo termin\u00f3 de salir."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3."
          }
        },
        "required": [
          "id",
          "object",
          "customer",
          "subscription",
          "invoice",
          "kind",
          "subject",
          "message",
          "channels",
          "sent_at",
          "livemode",
          "created"
        ]
      },
      "subscription_action": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`sa_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`subscription_action`"
          },
          "subscription": {
            "type": "string",
            "description": "La suscripci\u00f3n (`sub_\u2026`)."
          },
          "kind": {
            "type": [
              "string",
              "null"
            ],
            "description": "`pause`, `resume`, `extend_period`, `extend_trial`, `end_trial`, `apply_coupon`, `remove_discount`, `manual_payment`, `void`, `refund` o `entitlements` (ajust\u00f3 los derechos: `details` con `features_add`, `features_remove` y `limits` como quedaron, `previous` con los de antes, `cleared` y `keep_current`)."
          },
          "actor": {
            "type": "string",
            "description": "Qui\u00e9n (la llave \u00abnombre\u00bb o el correo de la persona)."
          },
          "reason": {
            "type": "string",
            "description": "Por qu\u00e9."
          },
          "details": {
            "type": [
              "object",
              "null"
            ],
            "description": "Lo que cambi\u00f3 (fechas antes y despu\u00e9s, la factura, el reembolso\u2026)."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo."
          }
        },
        "required": [
          "id",
          "object",
          "subscription",
          "kind",
          "actor",
          "reason",
          "details",
          "livemode",
          "created"
        ]
      },
      "event": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`evt_\u2026` \u2014 deduplica con \u00e9l."
          },
          "object": {
            "type": "string",
            "description": "`event`"
          },
          "type": {
            "type": "string",
            "description": "Tipo (ver la lista de eventos)."
          },
          "sequence": {
            "type": "integer",
            "description": "Crece con cada evento: de dos eventos del mismo objeto, el de `sequence` mayor es el cambio posterior. No es consecutivo. Las entregas pueden llegar en otro orden: comp\u00e1ralo, o vuelve a consultar el objeto."
          },
          "api_version": {
            "type": "string",
            "description": "Versi\u00f3n con la que se arm\u00f3 `data`."
          },
          "data": {
            "type": [
              "object",
              "null"
            ],
            "description": "`object` (el objeto como lo responde la API) y, si cambi\u00f3, `previous_attributes`."
          },
          "request": {
            "type": [
              "object",
              "null"
            ],
            "description": "`id` e `idempotency_key` de la petici\u00f3n a la API que lo caus\u00f3, o `null`."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo pas\u00f3."
          }
        },
        "required": [
          "id",
          "object",
          "type",
          "sequence",
          "api_version",
          "data",
          "request",
          "livemode",
          "created"
        ]
      },
      "webhook_endpoint": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`we_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`webhook_endpoint`"
          },
          "url": {
            "type": "string",
            "description": "URL HTTPS p\u00fablica que recibe los eventos."
          },
          "description": {
            "type": "string",
            "description": "Para qu\u00e9 es."
          },
          "enabled_events": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Tipos que recibe; `[\"*\"]` = todos."
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "`enabled` o `disabled`."
          },
          "disabled_reason": {
            "type": "string",
            "description": "Por qu\u00e9 se desactiv\u00f3."
          },
          "api_version": {
            "type": "string",
            "description": "Versi\u00f3n de los eventos que recibe."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          }
        },
        "required": [
          "id",
          "object",
          "url",
          "description",
          "enabled_events",
          "status",
          "disabled_reason",
          "api_version",
          "metadata",
          "livemode",
          "created"
        ]
      },
      "checkout.session": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`cs_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`checkout.session`"
          },
          "status": {
            "type": [
              "string",
              "null"
            ],
            "description": "`open` (esperando al cliente), `complete` (la suscripci\u00f3n qued\u00f3 creada) o `expired`."
          },
          "url": {
            "type": "string",
            "description": "P\u00e1gina de pago hospedada a la que rediriges al cliente; `null` si ya no est\u00e1 abierta."
          },
          "price": {
            "type": "string",
            "description": "Precio de la primera l\u00ednea (expandible). Se conserva por compatibilidad: lo nuevo es `line_items`."
          },
          "line_items": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Lo que se suscribe, en orden: `[{object: line_item, price, quantity, amount, currency}]`, con el precio completo y `amount = price.amount \u00d7 quantity`. Son los \u00edtems de la suscripci\u00f3n que se crea. Una sesi\u00f3n creada con `price` tiene una l\u00ednea."
          },
          "amount_total": {
            "type": "integer",
            "description": "Lo que cuesta cada periodo: la suma de las l\u00edneas, en su moneda."
          },
          "currency": {
            "type": "string",
            "description": "`COP` o `USD`: la de sus precios."
          },
          "subscription_data": {
            "type": [
              "object",
              "null"
            ],
            "description": "`metadata` (la de la suscripci\u00f3n que se crea) y `trial_days` (el mismo valor que `trial_days`)."
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible): el que enviaste o el que se cre\u00f3 o encontr\u00f3 al pagar."
          },
          "customer_email": {
            "type": "string",
            "description": "Correo sugerido (no editable en la p\u00e1gina)."
          },
          "customer_fields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Datos que se piden adem\u00e1s del correo: `name`, `legal_id`, `phone`."
          },
          "trial_days": {
            "type": "integer",
            "description": "D\u00edas de prueba de esta suscripci\u00f3n; `null` = los del precio."
          },
          "success_url": {
            "type": "string",
            "description": "A d\u00f3nde vuelve el cliente al terminar, con `?session_id=cs_\u2026`."
          },
          "cancel_url": {
            "type": "string",
            "description": "A d\u00f3nde vuelve si se arrepiente."
          },
          "client_reference_id": {
            "type": "string",
            "description": "Tu referencia (el id de tu usuario, por ejemplo)."
          },
          "payment_link": {
            "type": "string",
            "description": "Enlace de pago que la abri\u00f3 (expandible)."
          },
          "subscription": {
            "type": "string",
            "description": "Suscripci\u00f3n creada (expandible)."
          },
          "payment_method": {
            "type": "string",
            "description": "Tarjeta guardada (expandible)."
          },
          "expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Vence 24 horas despu\u00e9s de creada."
          },
          "completed_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se complet\u00f3."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          },
          "updated": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "\u00daltimo cambio del objeto (ISO 8601, UTC, como `created`): se mueve con cada modificaci\u00f3n. Comp\u00e1ralo con el de tu copia local antes de pisarla: si la tuya es m\u00e1s nueva, el dato que lleg\u00f3 es viejo."
          }
        },
        "required": [
          "id",
          "object",
          "status",
          "url",
          "price",
          "line_items",
          "amount_total",
          "currency",
          "subscription_data",
          "customer",
          "customer_email",
          "customer_fields",
          "trial_days",
          "success_url",
          "cancel_url",
          "client_reference_id",
          "payment_link",
          "subscription",
          "payment_method",
          "expires_at",
          "completed_at",
          "metadata",
          "livemode",
          "created",
          "updated"
        ]
      },
      "payment_link": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`plink_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`payment_link`"
          },
          "url": {
            "type": "string",
            "description": "URL p\u00fablica para compartir: cada visita abre un checkout."
          },
          "active": {
            "type": "boolean",
            "description": "`false`: el enlace ya no abre checkouts."
          },
          "price": {
            "type": "string",
            "description": "Precio de la primera l\u00ednea (expandible)."
          },
          "line_items": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Lo que vende, en orden: `[{object: line_item, price, quantity, amount, currency}]` (cada checkout que abre las lleva)."
          },
          "amount_total": {
            "type": "integer",
            "description": "Lo que cuesta cada periodo: la suma de las l\u00edneas."
          },
          "currency": {
            "type": "string",
            "description": "`COP` o `USD`: la de sus precios."
          },
          "customer_fields": {
            "type": "array",
            "items": {
              "type": "string"
            },
            "description": "Datos que se piden adem\u00e1s del correo: `name`, `legal_id`, `phone`."
          },
          "trial_days": {
            "type": "integer",
            "description": "D\u00edas de prueba; `null` = los del precio."
          },
          "success_url": {
            "type": "string",
            "description": "A d\u00f3nde vuelve el cliente al terminar; `null` = la p\u00e1gina de Bucli lo confirma."
          },
          "sessions_count": {
            "type": "integer",
            "description": "Cu\u00e1ntos checkouts abri\u00f3."
          },
          "metadata": {
            "type": [
              "object",
              "null"
            ],
            "description": "Tus pares clave-valor."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n, `false` en pruebas."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 (ISO 8601, UTC)."
          }
        },
        "required": [
          "id",
          "object",
          "url",
          "active",
          "price",
          "line_items",
          "amount_total",
          "currency",
          "customer_fields",
          "trial_days",
          "success_url",
          "sessions_count",
          "metadata",
          "livemode",
          "created"
        ]
      },
      "portal.session": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`bps_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`portal.session`"
          },
          "customer": {
            "type": "string",
            "description": "Cliente (expandible)."
          },
          "return_url": {
            "type": "string",
            "description": "A d\u00f3nde vuelve el cliente desde el portal."
          },
          "url": {
            "type": "string",
            "description": "Portal del cliente; solo en la respuesta de creaci\u00f3n (es una credencial): `null` al consultarla."
          },
          "expires_at": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Vence una hora despu\u00e9s de creada."
          },
          "livemode": {
            "type": "boolean",
            "description": "`true` en producci\u00f3n."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3."
          }
        },
        "required": [
          "id",
          "object",
          "customer",
          "return_url",
          "url",
          "expires_at",
          "livemode",
          "created"
        ]
      },
      "account": {
        "type": "object",
        "properties": {
          "id": {
            "type": "string",
            "description": "`acct_\u2026`"
          },
          "object": {
            "type": "string",
            "description": "`account`"
          },
          "name": {
            "type": "string",
            "description": "Nombre del comercio."
          },
          "api_version": {
            "type": "string",
            "description": "Versi\u00f3n fijada de la cuenta (o la pedida con `Bucli-Version`)."
          },
          "livemode": {
            "type": "boolean",
            "description": "Modo de la llave."
          },
          "default_currency": {
            "type": "string",
            "description": "`COP`."
          },
          "country": {
            "type": "string",
            "description": "`CO`."
          },
          "webhooks_enabled": {
            "type": "boolean",
            "description": "Si el plan env\u00eda webhooks."
          },
          "created": {
            "type": [
              "string",
              "null"
            ],
            "format": "date-time",
            "description": "Cu\u00e1ndo se cre\u00f3 la cuenta."
          }
        },
        "required": [
          "id",
          "object",
          "name",
          "api_version",
          "livemode",
          "default_currency",
          "country",
          "webhooks_enabled",
          "created"
        ]
      },
      "List": {
        "type": "object",
        "required": [
          "object",
          "data",
          "has_more",
          "url"
        ],
        "properties": {
          "object": {
            "const": "list"
          },
          "data": {
            "type": "array",
            "items": {
              "type": "object"
            }
          },
          "has_more": {
            "type": "boolean"
          },
          "url": {
            "type": "string"
          }
        }
      },
      "Deleted": {
        "type": "object",
        "required": [
          "id",
          "object",
          "deleted"
        ],
        "properties": {
          "id": {
            "type": "string"
          },
          "object": {
            "type": "string"
          },
          "deleted": {
            "const": true
          }
        }
      },
      "Error": {
        "type": "object",
        "required": [
          "error"
        ],
        "properties": {
          "error": {
            "type": "object",
            "required": [
              "type",
              "code",
              "message",
              "param",
              "doc_url",
              "request_id"
            ],
            "properties": {
              "type": {
                "type": "string",
                "enum": [
                  "api_error",
                  "authentication_error",
                  "billing_error",
                  "idempotency_error",
                  "invalid_request_error",
                  "permission_error",
                  "rate_limit_error"
                ]
              },
              "code": {
                "type": "string",
                "enum": [
                  "parameter_missing",
                  "parameter_invalid",
                  "parameter_unknown",
                  "invalid_json",
                  "request_too_large",
                  "resource_missing",
                  "url_invalid",
                  "api_version_invalid",
                  "mode_mismatch",
                  "api_key_missing",
                  "authorization_header_invalid",
                  "api_key_invalid",
                  "api_key_revoked",
                  "authentication_required",
                  "no_active_subscription",
                  "subscription_read_only",
                  "module_not_active",
                  "feature_not_available",
                  "secret_key_required",
                  "permission_denied",
                  "account_forbidden",
                  "support_read_only",
                  "route_not_found",
                  "method_not_allowed",
                  "resource_already_exists",
                  "idempotency_key_in_use",
                  "idempotency_key_reused",
                  "webhook_secret_unavailable_on_replay",
                  "url_unavailable_on_replay",
                  "reauth_failed",
                  "code_required",
                  "reauth_locked",
                  "customer_has_active_subscriptions",
                  "customer_has_open_charges",
                  "product_has_prices",
                  "price_in_use",
                  "product_inactive",
                  "active_subscriptions_limit_reached",
                  "price_inactive",
                  "customer_deleted",
                  "payment_method_unavailable",
                  "payment_method_rejected",
                  "invalid_metadata",
                  "subscription_not_updatable",
                  "invalid_cancellation_reason",
                  "invoice_not_open",
                  "coupon_terms_frozen",
                  "coupon_not_redeemable",
                  "discount_missing",
                  "payment_not_refundable",
                  "payment_not_voidable",
                  "refund_in_progress",
                  "subscription_not_pausable",
                  "subscription_not_paused",
                  "subscription_not_extendable",
                  "trial_not_running",
                  "plan_price_required",
                  "fixed_term_offer_open",
                  "fixed_term_offer_not_open",
                  "fixed_term_unavailable",
                  "fixed_term_not_changeable",
                  "manual_payment_reference_used",
                  "exchange_rate_unavailable",
                  "invoice_payment_in_progress",
                  "invoice_charge_blocked",
                  "invoice_not_voidable",
                  "price_not_recurring",
                  "price_not_one_time",
                  "price_interval_mismatch",
                  "price_currency_mismatch",
                  "subscription_item_duplicate_price",
                  "subscription_item_last",
                  "subscription_items_invalid",
                  "subscription_has_multiple_items",
                  "quantity_invalid",
                  "proration_unavailable",
                  "quote_changed",
                  "payment_method_required",
                  "payment_method_is_default",
                  "subscription_update_in_progress",
                  "subscription_change_too_complex",
                  "billing_cycle_anchor_invalid",
                  "trial_end_invalid",
                  "invoice_lines_invalid",
                  "invoice_amount_too_small",
                  "customer_payment_method_missing",
                  "wompi_payment_source_missing",
                  "wompi_payment_source_unavailable",
                  "wompi_payment_source_unsupported",
                  "payment_method_attached_elsewhere",
                  "wompi_credentials_missing",
                  "wompi_credentials_invalid",
                  "wompi_unavailable",
                  "checkout_session_not_expirable",
                  "webhook_endpoint_limit_reached",
                  "feature_in_use",
                  "feature_unknown",
                  "feature_type_mismatch",
                  "limit_invalid",
                  "limit_unlimited_not_allowed",
                  "product_rules_invalid",
                  "trial_product_exists",
                  "trial_product_locked",
                  "trial_price_invalid",
                  "product_not_offered",
                  "product_coming_soon",
                  "quantity_not_supported",
                  "addon_requires_feature",
                  "addon_requires_plan",
                  "addon_included",
                  "addon_not_allowed_during_trial",
                  "trial_product_misused",
                  "trial_already_used",
                  "meter_feature_missing",
                  "meter_inactive",
                  "quota_exhausted",
                  "entitlement_access_denied",
                  "usage_report_invalid",
                  "usage_idempotency_key_reused",
                  "grant_offer_price_invalid",
                  "grant_offer_unavailable",
                  "grant_offer_requires_feature",
                  "grant_not_withdrawable",
                  "rate_limited",
                  "internal_error",
                  "engine_unavailable"
                ]
              },
              "message": {
                "type": "string"
              },
              "param": {
                "type": [
                  "string",
                  "null"
                ]
              },
              "doc_url": {
                "type": "string"
              },
              "request_id": {
                "type": "string"
              }
            }
          }
        }
      }
    }
  },
  "webhooks": {
    "customer.created": {
      "post": {
        "summary": "Se cre\u00f3 un cliente.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "customer.updated": {
      "post": {
        "summary": "Cambi\u00f3 un cliente.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "customer.deleted": {
      "post": {
        "summary": "Se elimin\u00f3 un cliente.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "product.created": {
      "post": {
        "summary": "Se cre\u00f3 un producto.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "product.updated": {
      "post": {
        "summary": "Cambi\u00f3 un producto: su nombre, lo que da, sus reglas, c\u00f3mo se muestra en la vitrina, o su `kind` porque un precio nuevo lo volvi\u00f3 paquete o plan (`previous_attributes` trae lo que ten\u00eda, con la forma del objeto).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "subscription.created": {
      "post": {
        "summary": "Se cre\u00f3 una suscripci\u00f3n.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "subscription.updated": {
      "post": {
        "summary": "Cambi\u00f3 una suscripci\u00f3n (estado, precio, m\u00e9todo de pago, cancelaci\u00f3n programada).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "subscription.canceled": {
      "post": {
        "summary": "Se cancel\u00f3 una suscripci\u00f3n.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "subscription.past_due": {
      "post": {
        "summary": "Un cobro de la suscripci\u00f3n fue rechazado y qued\u00f3 con pago atrasado.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "subscription.update_failed": {
      "post": {
        "summary": "Fall\u00f3 el cobro de un cambio prorrateado (o se anul\u00f3 su cobro): la suscripci\u00f3n qued\u00f3 como estaba.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "subscription.trial_will_end": {
      "post": {
        "summary": "La prueba gratis termina en 3 d\u00edas.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "invoice.created": {
      "post": {
        "summary": "Se cre\u00f3 el cobro (`invoice`) de un periodo.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "invoice.paid": {
      "post": {
        "summary": "Wompi aprob\u00f3 un cobro (`invoice`).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "invoice.payment_failed": {
      "post": {
        "summary": "Wompi rechaz\u00f3 un cobro (`invoice`); se reintentar\u00e1 seg\u00fan el calendario.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "invoice.voided": {
      "post": {
        "summary": "Se anul\u00f3 un cobro (`invoice`).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "invoice.updated": {
      "post": {
        "summary": "Cambi\u00f3 el valor de un cobro (`invoice`) abierto: un cup\u00f3n aplicado mientras estaba pendiente.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "notice.sent": {
      "post": {
        "summary": "Bucli le envi\u00f3 un aviso a tu cliente (recibo, cobro fallido, tarjeta por vencer\u2026): ponlo en su campana.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "charge.refunded": {
      "post": {
        "summary": "Se devolvi\u00f3 dinero de un pago (reembolso total o parcial, o anulaci\u00f3n): el `refund` trae las l\u00edneas del cobro.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "invoice.fiscal_document.issued": {
      "post": {
        "summary": "La DIAN acept\u00f3 la factura electr\u00f3nica de una factura pagada: ya tiene n\u00famero, CUFE y PDF (`fiscal_document`).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "invoice.fiscal_document.rejected": {
      "post": {
        "summary": "La DIAN rechaz\u00f3 la factura electr\u00f3nica de una factura pagada; el motivo est\u00e1 en `fiscal_document.dian_message`.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "payment_method.attached": {
      "post": {
        "summary": "El cliente guard\u00f3 un m\u00e9todo de pago (checkout o portal).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "payment_method.detached": {
      "post": {
        "summary": "Se quit\u00f3 un m\u00e9todo de pago.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "payment_method.suspended": {
      "post": {
        "summary": "Un rechazo duro (robada, perdida, vencida): la tarjeta no se vuelve a cobrar.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "payment_method.expiring": {
      "post": {
        "summary": "La tarjeta vence en 30 o en 7 d\u00edas (`previous_attributes.days`).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "checkout.session.completed": {
      "post": {
        "summary": "El cliente termin\u00f3 un checkout.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "checkout.session.expired": {
      "post": {
        "summary": "Un checkout venci\u00f3 sin completarse.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "entitlements.updated": {
      "post": {
        "summary": "Cambiaron los derechos o el acceso de una suscripci\u00f3n (compra, cambio de plan, renovaci\u00f3n, vencimiento, ajuste o edici\u00f3n de un producto). Trae el objeto completo.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "meter.threshold_reached": {
      "post": {
        "summary": "Un cliente us\u00f3 el porcentaje de aviso de su cupo en la ventana (una vez por ventana).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "meter.exhausted": {
      "post": {
        "summary": "Un cliente gast\u00f3 su cupo y sus bolsas en la ventana (una vez por ventana).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "grant.created": {
      "post": {
        "summary": "Una bolsa qued\u00f3 vigente (pagada, regalada o importada).",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "grant.expired": {
      "post": {
        "summary": "Una bolsa venci\u00f3; lo que le quedaba se pierde.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    },
    "grant.withdrawn": {
      "post": {
        "summary": "Se retir\u00f3 lo que le quedaba a una bolsa.",
        "parameters": [
          {
            "name": "Bucli-Signature",
            "in": "header",
            "required": true,
            "schema": {
              "type": "string"
            },
            "description": "t=<timestamp>,v1=<HMAC-SHA256 de \u00abt.cuerpo\u00bb>"
          }
        ],
        "requestBody": {
          "content": {
            "application/json": {
              "schema": {
                "$ref": "#/components/schemas/event"
              }
            }
          }
        },
        "responses": {
          "200": {
            "description": "Recibido"
          }
        }
      }
    }
  },
  "x-guides": {
    "quickstart": {
      "title": "Tu primera suscripci\u00f3n en cuatro pasos",
      "steps": [
        "Crea el plan (un precio con su producto).",
        "Crea un checkout para tu cliente.",
        "Redirige al cliente a la `url` del checkout.",
        "Recibe `subscription.created` e `invoice.paid` en tu webhook."
      ],
      "samples": {
        "curl": "# 1. Crear el plan\ncurl https://api.bucli.co/v1/prices \\\n  -H \"Authorization: Bearer $BUCLI_SECRET_KEY\" \\\n  -H \"Idempotency-Key: plan-gold-1\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"product\": {\"name\": \"Plan Gold\"}, \"amount\": 89900, \"interval\": \"month\"}'\n\n# 2. Crear el checkout (responde una url)\ncurl https://api.bucli.co/v1/checkout_sessions \\\n  -H \"Authorization: Bearer $BUCLI_SECRET_KEY\" \\\n  -H \"Content-Type: application/json\" \\\n  -d '{\"price\": \"price_\u2026\", \"customer_email\": \"ana@ejemplo.co\",\n       \"success_url\": \"https://miapp.co/gracias\", \"cancel_url\": \"https://miapp.co/planes\"}'\n\n# 3. Redirige a tu cliente a la url recibida.\n# 4. Tu servidor recibe subscription.created e invoice.paid en tu webhook.\n",
        "node": "const BASE = \"https://api.bucli.co/v1\";\nconst headers = {\n  Authorization: `Bearer ${process.env.BUCLI_SECRET_KEY}`,\n  \"Content-Type\": \"application/json\",\n};\n\n// 1. Crear el plan\nconst price = await fetch(`${BASE}/prices`, {\n  method: \"POST\",\n  headers: { ...headers, \"Idempotency-Key\": \"plan-gold-1\" },\n  body: JSON.stringify({ product: { name: \"Plan Gold\" }, amount: 89900, interval: \"month\" }),\n}).then((r) => r.json());\n\n// 2. Crear el checkout\nconst session = await fetch(`${BASE}/checkout_sessions`, {\n  method: \"POST\",\n  headers,\n  body: JSON.stringify({\n    price: price.id,\n    customer_email: \"ana@ejemplo.co\",\n    success_url: \"https://miapp.co/gracias\",\n    cancel_url: \"https://miapp.co/planes\",\n  }),\n}).then((r) => r.json());\n\n// 3. Redirigir (Express)\nres.redirect(303, session.url);\n\n// 4. El webhook: ver \u00abVerificar la firma\u00bb.\n",
        "python": "import os\n\nimport requests\n\nBASE = \"https://api.bucli.co/v1\"\nHEADERS = {\"Authorization\": f\"Bearer {os.environ['BUCLI_SECRET_KEY']}\"}\n\n# 1. Crear el plan\nprice = requests.post(\n    f\"{BASE}/prices\",\n    headers={**HEADERS, \"Idempotency-Key\": \"plan-gold-1\"},\n    json={\"product\": {\"name\": \"Plan Gold\"}, \"amount\": 89900, \"interval\": \"month\"},\n    timeout=30,\n).json()\n\n# 2. Crear el checkout\nsession = requests.post(\n    f\"{BASE}/checkout_sessions\",\n    headers=HEADERS,\n    json={\n        \"price\": price[\"id\"],\n        \"customer_email\": \"ana@ejemplo.co\",\n        \"success_url\": \"https://miapp.co/gracias\",\n        \"cancel_url\": \"https://miapp.co/planes\",\n    },\n    timeout=30,\n).json()\n\n# 3. Redirigir a session[\"url\"] (Django: return redirect(session[\"url\"])).\n# 4. El webhook: ver \u00abVerificar la firma\u00bb.\n",
        "php": "<?php\n$base = 'https://api.bucli.co/v1';\n$key = getenv('BUCLI_SECRET_KEY');\n\nfunction bucli($method, $url, $key, $body, $idempotencyKey = null) {\n    $headers = [\"Authorization: Bearer $key\", 'Content-Type: application/json'];\n    if ($idempotencyKey) { $headers[] = \"Idempotency-Key: $idempotencyKey\"; }\n    $ch = curl_init($url);\n    curl_setopt_array($ch, [\n        CURLOPT_CUSTOMREQUEST => $method,\n        CURLOPT_HTTPHEADER => $headers,\n        CURLOPT_POSTFIELDS => json_encode($body),\n        CURLOPT_RETURNTRANSFER => true,\n    ]);\n    $response = json_decode(curl_exec($ch), true);\n    curl_close($ch);\n    return $response;\n}\n\n// 1. Crear el plan\n$price = bucli('POST', \"$base/prices\", $key,\n    ['product' => ['name' => 'Plan Gold'], 'amount' => 89900, 'interval' => 'month'], 'plan-gold-1');\n\n// 2. Crear el checkout\n$session = bucli('POST', \"$base/checkout_sessions\", $key, [\n    'price' => $price['id'],\n    'customer_email' => 'ana@ejemplo.co',\n    'success_url' => 'https://miapp.co/gracias',\n    'cancel_url' => 'https://miapp.co/planes',\n]);\n\n// 3. Redirigir\nheader('Location: ' . $session['url'], true, 303);\n\n// 4. El webhook: ver \u00abVerificar la firma\u00bb.\n"
      }
    },
    "conventions": [
      "Autenticaci\u00f3n: `Authorization: Bearer sk_test_\u2026` (pruebas, sandbox de Wompi) o `sk_live_\u2026` (producci\u00f3n). La llave decide el modo. Las `pk_` solo crean checkouts desde el navegador.",
      "Ids con prefijo (`cus_`, `prod_`, `price_`, `sub_`, `in_`, `py_`, `pm_`, `evt_`, `we_`) y `object` en cada respuesta.",
      "`Idempotency-Key` en los POST: la misma clave repite la respuesta guardada (24 h, con `Idempotent-Replayed: true`); con otro cuerpo responde `409 idempotency_key_reused`. No se guardan los errores 5xx, 402, 404 ni 409 (reintentar con la misma clave vuelve a ejecutar la petici\u00f3n). La respuesta guardada no conserva secretos, URL con token ni el documento o el tel\u00e9fono de tus clientes: esos campos vienen ocultos, y si la respuesta tra\u00eda un secreto de firma o la URL de una sesi\u00f3n, el replay responde `409 webhook_secret_unavailable_on_replay` o `409 url_unavailable_on_replay`, con el id del objeto en `error.object_id` (y su tipo en `error.object_type`).",
      "Listas: `limit` (1 a 100, por defecto 10), `starting_after`, `ending_before` \u2192 `{object: \"list\", data, has_more, url}`.",
      "`expand[]=customer` trae el objeto relacionado completo (en listas, `expand[]=data.customer`): hasta 4 caminos por petici\u00f3n, de hasta 4 niveles.",
      "El cuerpo de una petici\u00f3n admite hasta 256 KB (`413 request_too_large`).",
      "Montos en pesos enteros (`89900` = $89.900); fechas ISO 8601 en UTC. `created` y `updated` (\u00faltimo cambio) van en el mismo formato: usa `updated` para no pisar tu copia local con un dato m\u00e1s viejo.",
      "Versi\u00f3n: `Bucli-Version` (vigente: `2026-11-01`); tu cuenta queda fijada a la de su creaci\u00f3n.",
      "Cada respuesta trae `Request-Id`; cada error, `{error: {type, code, message, param, doc_url, request_id}}`.",
      "L\u00edmite por llave: 100 peticiones por segundo en producci\u00f3n y 25 en pruebas, con cabeceras `RateLimit-*`; adem\u00e1s, todas las llaves de tu cuenta juntas: 200 por segundo en producci\u00f3n y 50 en pruebas. Una llave `pk_` cuenta por llave y direcci\u00f3n IP (10 por segundo). Una lista con `expand[]` cuesta `1 + limit \u00d7 caminos \u00f7 20` peticiones.",
      "Eventos y webhooks: el orden de entrega no est\u00e1 garantizado. Cada evento trae `sequence` (crece con cada evento): comp\u00e1ralo, o vuelve a consultar el objeto, antes de actuar.",
      "Llaves de producci\u00f3n: en el dashboard las crea, renombra, regenera o revoca solo el propietario o un administrador (`developers.api_keys.manage_live`), confirmando su identidad; el rol Desarrollador gestiona las de pruebas. Cada llave de producci\u00f3n nueva o regenerada se avisa por correo al propietario, y las llaves que cre\u00f3 un miembro se revocan cuando sale del equipo."
    ],
    "webhooks": {
      "text": "Cada entrega trae la cabecera `Bucli-Signature: t=<timestamp>,v1=<firma>`. Calcula `HMAC-SHA256(secreto, \"<t>.<cuerpo crudo>\")` en hexadecimal con el secreto `whsec_\u2026` del endpoint, comp\u00e1ralo en tiempo constante con CADA `v1` de la cabecera (durante las 24 horas que siguen a regenerar el secreto llegan dos: la del anterior y, la \u00faltima, la del nuevo) y acepta si alguna coincide; rechaza un `t` de hace m\u00e1s de 5 minutos. Responde `2xx` r\u00e1pido (tenemos 10 segundos en total para enviarte el evento y leer tu respuesta) y procesa despu\u00e9s; deduplica por el `id` del evento (un reintento trae el mismo). **El orden no est\u00e1 garantizado**: cada entrega viaja sola y los reintentos las reordenan. Usa `sequence` (mayor = cambio posterior del objeto) o vuelve a consultar el objeto con la API antes de actuar. Si fallas, reintentamos a 1 min, 5 min, 30 min, 2 h, 6 h y 24 h (tras muchos fallos seguidos pausamos tu endpoint unos minutos entre intentos); tras 3 d\u00edas fallando lo desactivamos y te avisamos por correo.",
      "samples": {
        "python": "import hashlib\nimport hmac\nimport time\n\nTOLERANCE = 300\n\n\ndef verify(body, header, secret):\n    items = [item.split(\"=\", 1) for item in header.split(\",\") if \"=\" in item]\n    timestamp = int(next((value for key, value in items if key == \"t\"), \"0\"))\n    if abs(time.time() - timestamp) > TOLERANCE:\n        return False\n    expected = hmac.new(secret.encode(), f\"{timestamp}.{body}\".encode(), hashlib.sha256).hexdigest()\n    # Tras regenerar el secreto llegan dos v1 durante 24 h: basta con que una coincida.\n    return any(hmac.compare_digest(expected, value) for key, value in items if key == \"v1\")\n",
        "node": "const crypto = require(\"crypto\");\nconst TOLERANCE = 300;\n\nfunction verify(body, header, secret) {\n  const items = header.split(\",\").map((p) => p.split(\"=\"));\n  const t = Number((items.find(([k]) => k === \"t\") || [])[1]);\n  if (Math.abs(Date.now() / 1000 - t) > TOLERANCE) return false;\n  const expected = Buffer.from(crypto.createHmac(\"sha256\", secret).update(`${t}.${body}`).digest(\"hex\"));\n  // Tras regenerar el secreto llegan dos v1 durante 24 h: basta con que una coincida.\n  return items\n    .filter(([k]) => k === \"v1\")\n    .some(([, v]) => Buffer.byteLength(v || \"\") === expected.length && crypto.timingSafeEqual(expected, Buffer.from(v)));\n}\n// Express: app.post(\"/webhooks/bucli\", express.raw({ type: \"application/json\" }), (req, res) => { \u2026 })\n",
        "php": "<?php\nfunction verify(string $body, string $header, string $secret): bool {\n    $t = 0;\n    $signatures = [];\n    foreach (explode(',', $header) as $item) {\n        [$k, $v] = array_pad(explode('=', $item, 2), 2, '');\n        if ($k === 't') { $t = (int) $v; }\n        if ($k === 'v1') { $signatures[] = $v; }  // dos durante 24 h tras regenerar el secreto\n    }\n    if (abs(time() - $t) > 300) { return false; }\n    $expected = hash_hmac('sha256', \"$t.$body\", $secret);\n    foreach ($signatures as $signature) {\n        if (hash_equals($expected, $signature)) { return true; }\n    }\n    return false;\n}\n// $body = file_get_contents('php://input'); $header = $_SERVER['HTTP_BUCLI_SIGNATURE'];\n",
        "curl": "# Para probar tu verificaci\u00f3n, firma un cuerpo t\u00fa mismo:\nt=$(date +%s); body='{\"id\":\"evt_test\",\"type\":\"invoice.paid\"}'\nsig=$(printf '%s' \"$t.$body\" | openssl dgst -sha256 -hmac \"$BUCLI_WEBHOOK_SECRET\" | sed 's/^.* //')\ncurl https://miapp.co/webhooks/bucli -H \"Bucli-Signature: t=$t,v1=$sig\" -H \"Content-Type: application/json\" -d \"$body\"\n"
      }
    }
  }
}