{
  "info": {
    "_postman_id": "21ee6d31-4e48-5736-a4cc-8a9e721ba4d2",
    "name": "API de Bucli",
    "description": "API pública de Bucli, versión 2026-11-01. Pega tu llave secreta en la variable `secretKey` de la colección (Desarrolladores → Llaves de la API): `sk_test_…` para pruebas, `sk_live_…` para producción. Cada POST lleva su propia `Idempotency-Key`.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{secretKey}}",
        "type": "string"
      }
    ]
  },
  "event": [
    {
      "listen": "prerequest",
      "script": {
        "type": "text/javascript",
        "exec": [
          "// Bucli: a fresh Idempotency-Key on every POST, so a retry never books twice.",
          "if (pm.request.method === 'POST' && !pm.request.headers.has('Idempotency-Key')) {",
          "  pm.request.headers.upsert({ key: 'Idempotency-Key', value: pm.variables.replaceIn('{{$guid}}') });",
          "}"
        ]
      }
    }
  ],
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.bucli.co/v1",
      "type": "string"
    },
    {
      "key": "secretKey",
      "value": "",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "Clientes",
      "description": "Quién paga tus suscripciones.",
      "item": [
        {
          "name": "Crear un cliente",
          "id": "customers-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers"
              ]
            },
            "description": "El correo es único por cuenta y modo: uno repetido responde `409 resource_already_exists`.\n\n**Permiso:** `billing.customers.create`\n\n**Cuerpo:**\n- `email` (string, obligatorio): Correo del cliente.\n- `external_id` (string): Tu id del cliente (hasta 120): único por modo. Con él, varios clientes pueden compartir correo (un cliente por empresa); un checkout público nunca encuentra un cliente con `external_id` por el correo.\n- `name` (string): Nombre.\n- `phone` (string): Celular.\n- `legal_id_type` (enum): Tipo de documento.\n- `legal_id` (string): Número de documento.\n- `fiscal` (object): Sus datos para la factura electrónica, 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ías. Son los datos ya llenos que el cliente confirma o corrige en el checkout y el portal: lo que corrija ahí (o el comercio en el panel) ya no lo reemplaza tu `fiscal`, y la respuesta trae los datos vigentes con su `source`.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"email\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar clientes",
          "id": "customers-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "email",
                  "value": "",
                  "description": "Correo exacto (puede haber varios con `external_id`).",
                  "disabled": true
                },
                {
                  "key": "external_id",
                  "value": "",
                  "description": "Tu id exacto.",
                  "disabled": true
                },
                {
                  "key": "metadata[<clave>]",
                  "value": "",
                  "description": "Solo los que tienen ese par en su metadata.",
                  "disabled": true
                }
              ]
            },
            "description": "Del más reciente al más antiguo. Los eliminados no aparecen.\n\n**Permiso:** `billing.customers.list`"
          }
        },
        {
          "name": "Consultar un cliente",
          "id": "customers-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Un cliente eliminado responde `{id, object, deleted: true}`.\n\n**Permiso:** `billing.customers.retrieve`"
          }
        },
        {
          "name": "Actualizar un cliente",
          "id": "customers-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Cambia solo lo que envías. Emite `customer.updated` con `previous_attributes`.\n\n**Permiso:** `billing.customers.update`\n\n**Cuerpo:**\n- `email` (string): Correo del cliente.\n- `external_id` (string): Tu id del cliente (hasta 120): único por modo. Con él, varios clientes pueden compartir correo (un cliente por empresa); un checkout público nunca encuentra un cliente con `external_id` por el correo.\n- `name` (string): Nombre.\n- `phone` (string): Celular.\n- `legal_id_type` (enum): Tipo de documento.\n- `legal_id` (string): Número de documento.\n- `fiscal` (object): Sus datos para la factura electrónica, 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ías. Son los datos ya llenos que el cliente confirma o corrige en el checkout y el portal: lo que corrija ahí (o el comercio en el panel) ya no lo reemplaza tu `fiscal`, y la respuesta trae los datos vigentes con su `source`.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Eliminar un cliente",
          "id": "customers-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "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`.\n\n**Permiso:** `billing.customers.destroy`"
          }
        }
      ]
    },
    {
      "name": "Productos",
      "description": "Lo que vendes.",
      "item": [
        {
          "name": "Crear un producto",
          "id": "products-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products"
              ]
            },
            "description": "Lo que vendes («Plan Gold»); el monto va en sus precios. Emite `product.created`.\n\n**Permiso:** `billing.products.create`\n\n**Cuerpo:**\n- `name` (string, obligatorio): Nombre.\n- `description` (string): Descripción.\n- `active` (boolean): Activo (por defecto `true`).\n- `key` (string): Tu código del producto, único por modo.\n- `entitlements` (object): `{features: [claves], limits: {clave: número}}` de tu vocabulario; `-1` = ilimitado. Se reemplaza entero.\n- `is_addon` (boolean): Es un adicional.\n- `is_trial` (boolean): Es tu producto de prueba (uno activo por modo); no cambia si ya tiene precios.\n- `supports_quantity` (boolean): Se vende por unidades (por defecto `true`).\n- `requires_features` (array): Adicional: módulos que la suscripción ya debe tener.\n- `allowed_base_products` (array): Adicional: ids de los planes sobre los que se vende (vacío = todos).\n- `skip_if_included` (boolean): Adicional: no se vende si el plan ya da todos sus módulos.\n- `allowed_during_trial` (boolean): Adicional: se vende durante la prueba (por defecto `false`).\n- `prorate_limits_on_add` (boolean): Prorratear sus cupos medidos al agregarlo a mitad de ventana.\n- `meter_window` (enum): Mientras sea el plan base de la suscripción, los medidores cuentan en esta ventana y no en la suya (`subscription_lifetime`: la prueba o el plazo fijo de punta a punta). Vacío = la del medidor.\n- `availability` (enum): Disponibilidad.\n- `availability_note` (string): Nota de disponibilidad.\n- `marketing_features` (array): Textos de la vitrina (hasta 30).\n- `position` (integer): Orden en la vitrina.\n- `featured` (boolean): Destacado.\n- `visible_in_pricing` (boolean): Visible en la vitrina (por defecto `true`).\n- `placement` (enum): En la vitrina: `main` (por defecto), una tarjeta entre los planes principales; `secondary`, una línea bajo ellos.\n- `icon` (string): Ícono.\n- `group` (string): Grupo libre (`module`, `seats`, `units`…).\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar productos",
          "id": "products-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "active",
                  "value": "",
                  "description": "Solo activos o archivados.",
                  "disabled": true
                },
                {
                  "key": "key",
                  "value": "",
                  "description": "Tu código exacto.",
                  "disabled": true
                },
                {
                  "key": "availability",
                  "value": "",
                  "description": "Disponibilidad.",
                  "disabled": true
                },
                {
                  "key": "is_addon",
                  "value": "",
                  "description": "Solo adicionales o solo planes.",
                  "disabled": true
                },
                {
                  "key": "is_trial",
                  "value": "",
                  "description": "Solo el producto de prueba.",
                  "disabled": true
                },
                {
                  "key": "group",
                  "value": "",
                  "description": "Grupo exacto.",
                  "disabled": true
                },
                {
                  "key": "visible_in_pricing",
                  "value": "",
                  "description": "Solo los visibles en la vitrina.",
                  "disabled": true
                },
                {
                  "key": "placement",
                  "value": "",
                  "description": "Solo los de esa ubicación en la vitrina.",
                  "disabled": true
                },
                {
                  "key": "kind",
                  "value": "",
                  "description": "Solo los de ese tipo (`kind`).",
                  "disabled": true
                }
              ]
            },
            "description": "Del más reciente al más antiguo.\n\n**Permiso:** `billing.products.list`"
          }
        },
        {
          "name": "Consultar un producto",
          "id": "products-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.products.retrieve`"
          }
        },
        {
          "name": "Actualizar o archivar un producto",
          "id": "products-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "`active: false` lo archiva. Cambiar lo que da (`entitlements`, `supports_quantity`…) recalcula los derechos de todas sus suscripciones y emite `entitlements.updated` a cada una que cambie. Todo cambio emite `product.updated` con `previous_attributes`.\n\n**Permiso:** `billing.products.update`\n\n**Cuerpo:**\n- `name` (string): Nombre.\n- `description` (string): Descripción.\n- `active` (boolean): Activo (por defecto `true`).\n- `key` (string): Tu código del producto, único por modo.\n- `entitlements` (object): `{features: [claves], limits: {clave: número}}` de tu vocabulario; `-1` = ilimitado. Se reemplaza entero.\n- `is_addon` (boolean): Es un adicional.\n- `is_trial` (boolean): Es tu producto de prueba (uno activo por modo); no cambia si ya tiene precios.\n- `supports_quantity` (boolean): Se vende por unidades (por defecto `true`).\n- `requires_features` (array): Adicional: módulos que la suscripción ya debe tener.\n- `allowed_base_products` (array): Adicional: ids de los planes sobre los que se vende (vacío = todos).\n- `skip_if_included` (boolean): Adicional: no se vende si el plan ya da todos sus módulos.\n- `allowed_during_trial` (boolean): Adicional: se vende durante la prueba (por defecto `false`).\n- `prorate_limits_on_add` (boolean): Prorratear sus cupos medidos al agregarlo a mitad de ventana.\n- `meter_window` (enum): Mientras sea el plan base de la suscripción, los medidores cuentan en esta ventana y no en la suya (`subscription_lifetime`: la prueba o el plazo fijo de punta a punta). Vacío = la del medidor.\n- `availability` (enum): Disponibilidad.\n- `availability_note` (string): Nota de disponibilidad.\n- `marketing_features` (array): Textos de la vitrina (hasta 30).\n- `position` (integer): Orden en la vitrina.\n- `featured` (boolean): Destacado.\n- `visible_in_pricing` (boolean): Visible en la vitrina (por defecto `true`).\n- `placement` (enum): En la vitrina: `main` (por defecto), una tarjeta entre los planes principales; `secondary`, una línea bajo ellos.\n- `icon` (string): Ícono.\n- `group` (string): Grupo libre (`module`, `seats`, `units`…).\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Eliminar un producto",
          "id": "products-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/products/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "products",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Solo uno sin precios; si tiene, archívalo (`422 product_has_prices`).\n\n**Permiso:** `billing.products.destroy`"
          }
        }
      ]
    },
    {
      "name": "Precios",
      "description": "Cuánto y cada cuánto.",
      "item": [
        {
          "name": "Crear un precio",
          "id": "prices-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/prices",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "prices"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ]
            },
            "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és, para cambiarlo crea otro precio y archiva este.\n\n**Permiso:** `billing.prices.create`\n\n**Cuerpo:**\n- `product` (string, obligatorio): 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ías de prueba).\n- `amount` (integer, obligatorio): En la unidad de `currency`: pesos enteros (`89900`) o centavos de dólar (`2900`, mínimo `100`). `0` solo en el producto de prueba, cuyo precio es recurrente y con días de prueba.\n- `currency` (enum): `COP` (por defecto) o `USD`. Wompi cobra en pesos: un precio en dólares se convierte en cada cobro con la TRM vigente. Lo que se cobra junto (los ítems de una suscripción, un checkout, una factura única) va en una sola moneda (`400 price_currency_mismatch`).\n- `type` (enum): `recurring` (por defecto) o `one_time`: un pago único, sin intervalo ni prueba, que se vende en facturas únicas (`POST /invoices`), nunca en suscripciones ni checkouts.\n- `recurring` (object): `{interval, interval_count?, trial_days?}` (la forma de Stripe), en vez de los tres campos planos.\n- `interval` (enum): Por defecto `month`.\n- `interval_count` (integer): Por defecto 1.\n- `trial_days` (integer): Días de prueba (por defecto 0).\n- `nickname` (string): Nombre interno.\n- `active` (boolean): Por defecto `true`.\n- `metered_rates` (object): Excedente de un límite medido, solo en un precio recurrente: `{clave_del_medidor: {unit_amount, per_units?}}` — 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ón). Sin tarifa, al agotarse responde `402 quota_exhausted`.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"product\": \"…\",\n  \"amount\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar precios",
          "id": "prices-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/prices",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "prices"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "product",
                  "value": "",
                  "description": "Solo los de este producto.",
                  "disabled": true
                },
                {
                  "key": "active",
                  "value": "",
                  "description": "Activos o no.",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "",
                  "description": "Solo recurrentes o solo únicos.",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.prices.list`"
          }
        },
        {
          "name": "Consultar un precio",
          "id": "prices-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/prices/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "prices",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.prices.retrieve`"
          }
        },
        {
          "name": "Actualizar un precio",
          "id": "prices-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/prices/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "prices",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "`nickname`, `active`, `metadata` y `metered_rates` siempre. Los términos (`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.\n\n**Permiso:** `billing.prices.update`\n\n**Cuerpo:**\n- `nickname` (string): Nombre interno.\n- `active` (boolean): Archivar o reactivar.\n- `metered_rates` (object): Reemplaza las tarifas de excedente. Aplican a las unidades que se tomen desde ahora; cada una conserva la tarifa con la que se tomó.\n- `amount` (integer): Solo sin uso. En la unidad de `currency`, como al crearlo.\n- `currency` (enum): Solo sin uso, y con `amount` en la unidad de la nueva moneda.\n- `type` (enum): 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.\n- `recurring` (object): Solo sin uso. `{interval, interval_count?, trial_days?}`.\n- `interval` (enum): Solo sin uso.\n- `interval_count` (integer): Solo sin uso.\n- `trial_days` (integer): Solo sin uso.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        }
      ]
    },
    {
      "name": "Suscripciones",
      "description": "El contrato recurrente.",
      "item": [
        {
          "name": "Crear una suscripción",
          "id": "subscriptions-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ]
            },
            "description": "Para un cliente con un método de pago guardado. Un precio (`price`, con `quantity`) o varios ítems (`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ás de un ciclo) nace `active` sin cobrar nada ahora: el periodo actual va hasta esa fecha y ahí es el primer cobro — para migrar a quien ya pagó su periodo en otro sistema. `trial_end` fija el fin de la prueba con una fecha. En producción cuenta para el límite de tu plan (`402 active_subscriptions_limit_reached`): cuenta suscripciones, no ítems. Lo habitual es crearla con un checkout.\n\n**Permiso:** `billing.subscriptions.create`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Id del cliente.\n- `price` (string): Id de un precio recurrente activo (o envía `items`).\n- `quantity` (integer): Cantidad del precio (por defecto 1).\n- `items` (array): En vez de `price`: `[{price, quantity?, metadata?}]`, de 1 a 20, sin precios repetidos y con el mismo intervalo. `price` de la suscripción será el del primero.\n- `default_payment_method` (string): Id de un método del cliente (por defecto, su predeterminado).\n- `trial_days` (integer): Días de prueba (por defecto, los del precio).\n- `trial_end` (datetime): Fin de la prueba (ISO 8601 o timestamp Unix): futuro, a no más de 730 días. En vez de `trial_days`.\n- `billing_cycle_anchor` (datetime): Fecha del primer cobro (ISO 8601 o timestamp Unix): futura, a no más de un ciclo del precio ni de 730 días. Nace `active`, sin factura ahora. No va con `trial_days` ni `trial_end`.\n- `proration_behavior` (enum): Al crear no hay nada que prorratear: `none` o `create_prorations` dan lo mismo.\n- `trial_key` (string): Una prueba por clave (el documento del cliente, un correo): si la suscripción empieza en prueba y la clave ya se usó — aunque sea otro cliente o la anterior ya terminó — responde `409 trial_already_used`. Sin prueba se ignora.\n- `overage_caps` (object): Tope de excedente por ventana: `{clave_del_medidor: valor}` (0 = sin excedente). Un medidor que no esté vale lo que cuesta el plan. Lo fija el cliente en tu SaaS.\n- `coupon` (string): Id de un cupón: rebaja desde la primera factura de periodo.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar suscripciones",
          "id": "subscriptions-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Estado.",
                  "disabled": true
                },
                {
                  "key": "customer",
                  "value": "",
                  "description": "Id del cliente.",
                  "disabled": true
                },
                {
                  "key": "price",
                  "value": "",
                  "description": "Id del precio.",
                  "disabled": true
                },
                {
                  "key": "metadata[<clave>]",
                  "value": "",
                  "description": "Solo las que tienen ese par en su metadata (`metadata[legacy_id]=123`).",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.subscriptions.list`"
          }
        },
        {
          "name": "Consultar una suscripción",
          "id": "subscriptions-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Expande `customer`, `price`, `default_payment_method` o `latest_invoice`.\n\n**Permiso:** `billing.subscriptions.retrieve`"
          }
        },
        {
          "name": "Actualizar una suscripción",
          "id": "subscriptions-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "`price` cambia el único ítem; una suscripción de varios ítems los cambia en `/subscription_items` (`400 subscription_has_multiple_items`) o todos a la vez con `items` y `create_prorations` — así cambia de ciclo un plan con adicionales: el primer ítem 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ás largo empieza un periodo hoy) y aplica cuando se paga — responde `202` con el `subscription_change` mientras espera su cobro; si falla, la suscripción queda como estaba (`subscription.update_failed`) — y bajar (o un ciclo más corto) queda para la renovación.\n\n**Permiso:** `billing.subscriptions.update`\n\n**Cuerpo:**\n- `price` (string): Precio desde el próximo ciclo.\n- `items` (array): En vez de `price`, solo con `create_prorations` y `expected_amount`: todos los ítems después del cambio, `[{id?, price, quantity?}]` — `id` es un ítem actual (sin `quantity` conserva la suya); uno que no esté se quita. El ítem del plan va primero, y todos comparten su intervalo (`400 price_interval_mismatch`).\n- `default_payment_method` (string): Método con el que se cobra.\n- `cancel_at_period_end` (boolean): Cancelar al fin del periodo (o deshacerlo).\n- `proration_behavior` (enum): `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ón. Pide antes la vista previa (`POST /subscriptions/{id}/preview`).\n- `expected_amount` (integer): Con `create_prorations`: lo que la vista previa dijo que cuesta ahora. Si ya no cuadra responde `409 quote_changed` con la cotización nueva en `quote`.\n- `overage_caps` (object): Cambia los topes de excedente: `{clave_del_medidor: valor}` (0 = sin excedente; `null` = vuelve al valor del plan). Las claves que no envíes quedan como estaban.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Vista previa de un cambio",
          "id": "subscriptions-preview",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/preview",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "preview"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Lo que cuesta AHORA cambiar la suscripción, con el mismo cálculo que hace el cambio con `create_prorations`: días calendario desde hoy hasta el fin del periodo sobre los días del periodo, cada línea redondeada a la unidad de la moneda. `direction`: `up` (se cobra ya y aplica al pagarse), `down` (queda para la renovación, sin cobro ni devolución) o `even` (aplica ya, gratis). Lo que queda bajo el mínimo de Wompi no se cobra (`below_minimum`). En prueba todo aplica ya, gratis. No cambia nada.\n\n**Permiso:** `billing.subscriptions.update`\n\n**Cuerpo:**\n- `price` (string): Cambio de plan de una suscripción de un ítem.\n- `items` (array): Todos los ítems después del cambio: `[{id?, price, quantity?}]` — `id` es un ítem actual (sin `quantity` conserva la suya); uno que no esté se quita. El ítem del plan va primero: si cambia de intervalo, todos van al suyo (cambio de ciclo de un plan con adicionales)."
          }
        },
        {
          "name": "Cancelar una suscripción",
          "id": "subscriptions-cancel",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Al instante, o al fin del periodo con `at_period_end: true`. Los reembolsos se hacen en Wompi.\n\n**Permiso:** `billing.subscriptions.cancel`\n\n**Cuerpo:**\n- `at_period_end` (boolean): Por defecto `false`.\n- `reason` (enum): Motivo.\n- `comment` (string): Comentario."
          }
        },
        {
          "name": "Pausar el cobro",
          "id": "subscriptions-pause",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/pause",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "pause"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "El periodo pagado corre hasta su fin y luego la suscripción queda `paused`: solo lectura (sus derechos), sin deuda ni facturas, hasta que la reanudes — o sola en `resumes_at`. Solo una `active` o `trialing` sin pagos pendientes. Queda en la bitácora (`/actions`).\n\n**Permiso:** `billing.subscriptions.manage`\n\n**Cuerpo:**\n- `resumes_at` (datetime): Cuándo se reanuda sola (después del fin del periodo). Sin ella, a mano.\n- `reason` (string): Por qué (queda en la bitácora)."
          }
        },
        {
          "name": "Reanudar el cobro",
          "id": "subscriptions-resume",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/resume",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "resume"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Una pausa pedida que no ha empezado se deshace. Una suscripción `paused` empieza un periodo nuevo hoy (un día de cobro nuevo) y se cobra ya; sin tarjeta, la factura espera una y queda con pago atrasado.\n\n**Permiso:** `billing.subscriptions.manage`\n\n**Cuerpo:**\n- `reason` (string): Por qué."
          }
        },
        {
          "name": "Extender el periodo",
          "id": "subscriptions-extend-period",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/extend_period",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "extend_period"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Días gratis: el periodo en curso termina después y el día de cobro se mueve con él. Solo una `active` sin pagos pendientes (en prueba, extiende la prueba).\n\n**Permiso:** `billing.subscriptions.manage`\n\n**Cuerpo:**\n- `days` (integer): Cuántos días más (o `until`).\n- `until` (datetime): Hasta cuándo (o `days`).\n- `reason` (string): Por qué."
          }
        },
        {
          "name": "Extender la prueba",
          "id": "subscriptions-extend-trial",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/extend_trial",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "extend_trial"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "La prueba termina en `trial_end` (el primer cobro se mueve con ella). Una prueba más larga se avisa de nuevo tres días antes.\n\n**Permiso:** `billing.subscriptions.manage`\n\n**Cuerpo:**\n- `trial_end` (datetime, obligatorio): Nuevo fin de la prueba.\n- `reason` (string): Por qué.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"trial_end\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Terminar la prueba",
          "id": "subscriptions-end-trial",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/end_trial",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "end_trial"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "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ía `price`, termina). Con `price` pasa a ese plan (el mismo control que cambiar el precio; con un cupón del 100 % el periodo queda pagado sin tarjeta).\n\n**Permiso:** `billing.subscriptions.manage`\n\n**Cuerpo:**\n- `price` (string): El plan al que pasa (`price_…`): nunca el de la prueba ni el de un adicional. Con varios ítems, cámbialos antes.\n- `reason` (string): Por qué."
          }
        },
        {
          "name": "Aplicar un cupón",
          "id": "subscriptions-discount-apply",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/discount",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "discount"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Reemplaza el descuento vigente (uno por suscripción). 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ón se activa) y las de los periodos que vienen. Un cupón `once` se aplica una vez por suscripción; uno en valor fijo, solo en su moneda.\n\n**Permiso:** `billing.subscriptions.manage`\n\n**Cuerpo:**\n- `coupon` (string, obligatorio): Id del cupón.\n- `reason` (string): Por qué.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"coupon\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Quitar el descuento",
          "id": "subscriptions-discount-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/discount",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "discount"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Los cobros (`invoice`) ya abiertos lo conservan.\n\n**Permiso:** `billing.subscriptions.manage`\n\n**Cuerpo:**\n- `reason` (string): Por qué."
          }
        },
        {
          "name": "Bitácora de la suscripción",
          "id": "subscriptions-actions",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/actions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "actions"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Lo que se hizo a mano (pausa, días gratis, cupones, pagos manuales, reembolsos): quién, por qué y el detalle, de lo más reciente a lo más antiguo.\n\n**Permiso:** `billing.subscriptions.retrieve`"
          }
        }
      ]
    },
    {
      "name": "Ítems de suscripción",
      "description": "Plan base, puestos y adicionales.",
      "item": [
        {
          "name": "Agregar un ítem a una suscripción",
          "id": "subscription-items-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscription_items",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscription_items"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ]
            },
            "description": "Un precio recurrente × cantidad (un puesto adicional, un adicional), con el intervalo de la suscripción. Con `proration_behavior: none` se cobra desde el SIGUIENTE periodo. Con `create_prorations` se cobra ya por los días que quedan y el ítem llega cuando se paga (`202` con el `subscription_change`); bajo el mínimo de Wompi entra gratis hasta la renovación; agregar uno que estaba por quitarse lo deshace. Emite `subscription.updated` con los ítems anteriores en `previous_attributes.items`.\n\n**Permiso:** `billing.subscription_items.create`\n\n**Cuerpo:**\n- `subscription` (string, obligatorio): Id de la suscripción.\n- `price` (string, obligatorio): Id de un precio recurrente activo.\n- `quantity` (integer): Cantidad (por defecto 1).\n- `proration_behavior` (enum): `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ón. Pide antes la vista previa (`POST /subscriptions/{id}/preview`).\n- `expected_amount` (integer): Con `create_prorations`: lo que la vista previa dijo que cuesta ahora. Si ya no cuadra responde `409 quote_changed` con la cotización nueva en `quote`.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"subscription\": \"…\",\n  \"price\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar los ítems de una suscripción",
          "id": "subscription-items-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscription_items",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscription_items"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "subscription",
                  "value": "",
                  "description": "Id de la suscripción.",
                  "disabled": true
                }
              ]
            },
            "description": "Del más reciente al más antiguo; con `subscription`, solo los de esa suscripción (que ya los trae todos en `items`).\n\n**Permiso:** `billing.subscription_items.list`"
          }
        },
        {
          "name": "Consultar un ítem",
          "id": "subscription-items-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscription_items/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscription_items",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.subscription_items.retrieve`"
          }
        },
        {
          "name": "Cambiar un ítem",
          "id": "subscription-items-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscription_items/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscription_items",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "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ón (`scheduled_quantity` / `scheduled_price`). Cambiar el precio del primer ítem reemplaza un `pending_price`.\n\n**Permiso:** `billing.subscription_items.update`\n\n**Cuerpo:**\n- `price` (string): Otro precio recurrente del mismo intervalo.\n- `quantity` (integer): Cantidad nueva.\n- `proration_behavior` (enum): `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ón. Pide antes la vista previa (`POST /subscriptions/{id}/preview`).\n- `expected_amount` (integer): Con `create_prorations`: lo que la vista previa dijo que cuesta ahora. Si ya no cuadra responde `409 quote_changed` con la cotización nueva en `quote`.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Quitar un ítem",
          "id": "subscription-items-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscription_items/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscription_items",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Deja de cobrarse desde el siguiente periodo, sin reembolso. Con `create_prorations` el ítem se queda hasta la renovación (`scheduled_quantity: 0`) y se responde el ítem; agregarlo antes lo deshace. El último ítem no se quita (`400 subscription_item_last`): cancela la suscripción.\n\n**Permiso:** `billing.subscription_items.destroy`\n\n**Cuerpo:**\n- `proration_behavior` (enum): `none` (por defecto, se quita ya) o `create_prorations` (se queda hasta la renovación).\n- `expected_amount` (integer): Con `create_prorations`: `0` (quitar nunca cobra)."
          }
        }
      ]
    },
    {
      "name": "Métodos de pago",
      "description": "Tarjetas y Nequi guardados en Wompi.",
      "item": [
        {
          "name": "Listar los métodos de pago de un cliente",
          "id": "customers-payment-methods",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id/payment_methods",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id",
                "payment_methods"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Las tarjetas y cuentas Nequi que guardó en el checkout o el portal (la API no las crea: PCI).\n\n**Permiso:** `billing.payment_methods.list`"
          }
        },
        {
          "name": "Importar una fuente de pago de Wompi",
          "id": "payment-methods-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_methods",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_methods"
              ]
            },
            "description": "Para migrar a Bucli a un cliente que ya tiene su tarjeta guardada en TU cuenta de Wompi (sin pedírsela 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 últimos cuatro, el vencimiento y la evidencia de la importación (cuándo, con qué 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étodo ya guardado; para otro cliente, `409 payment_method_attached_elsewhere`. Queda predeterminado con `make_default` o si el cliente no tenía uno. Solo con la llave secreta (`sk_`), desde tu servidor. Emite `payment_method.attached`.\n\n**Permiso:** `billing.payment_methods.create`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Id del cliente (`cus_…`).\n- `wompi_payment_source_id` (string, obligatorio): Id numérico de la fuente de pago en Wompi.\n- `make_default` (boolean): Hacerla la predeterminada (por defecto `false`).\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\",\n  \"wompi_payment_source_id\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Consultar un método de pago",
          "id": "payment-methods-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_methods/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_methods",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Marca, últimos cuatro y vencimiento; nunca el número de la tarjeta.\n\n**Permiso:** `billing.payment_methods.list`"
          }
        },
        {
          "name": "Hacer predeterminado un método de pago",
          "id": "payment-methods-default",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_methods/:id/default",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_methods",
                ":id",
                "default"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Si el cliente tiene una suscripción con pago atrasado, el motor reintenta el cobro.\n\n**Permiso:** `billing.payment_methods.default`"
          }
        },
        {
          "name": "Hacer de respaldo un método de pago",
          "id": "payment-methods-backup",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_methods/:id/backup",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_methods",
                ":id",
                "backup"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "La segunda tarjeta del cliente: en cada ronda de cobro se intenta enseguida después de la predeterminada, y pasa a predeterminada si esa se suspende (un rechazo duro) o se quita. Solo una por cliente.\n\n**Permiso:** `billing.payment_methods.default`"
          }
        },
        {
          "name": "Quitar un método de pago",
          "id": "payment-methods-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_methods/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_methods",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Responde el método con `customer: null`.\n\n**Permiso:** `billing.payment_methods.destroy`"
          }
        }
      ]
    },
    {
      "name": "Cobros (facturas)",
      "description": "Lo que cuesta cada periodo: el objeto `invoice`, que en el panel se llama «cobro». No es la factura electrónica de la DIAN: esa la emite tu facturador (o la integración con Klopi, `fiscal_document`).",
      "item": [
        {
          "name": "Crear una factura única (un cobro único)",
          "id": "invoices-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoices",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoices"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ]
            },
            "description": "Un pago único sin suscripción —un paquete, un servicio adicional—: `lines` con precios de pago único (`type: one_time`) × 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`.\n\n**Permiso:** `billing.invoices.create`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Id del cliente.\n- `lines` (array): `[{price, quantity?, description?, metadata?}]`, de 1 a 20 precios de pago único activos.\n- `amount` (integer): Monto libre en vez de `lines` (con `description`), en la unidad de `currency`.\n- `currency` (enum): Con `amount`: `COP` (por defecto) o `USD`. Con `lines`, la de sus precios.\n- `description` (string): Qué se cobra; obligatoria con `amount`.\n- `default_payment_method` (string): Id de un método del cliente (por defecto, su predeterminado).\n- `auto_charge` (boolean): Cobrarla ya (por defecto `true`); con `false` espera a `/pay`.\n- `retry` (boolean): Reintentar un rechazo según tu calendario (por defecto `false`).\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar las líneas de una factura",
          "id": "invoices-lines",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoices/:id/lines",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoices",
                ":id",
                "lines"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Del más reciente al más antiguo. `invoice.lines` ya las trae todas.\n\n**Permiso:** `billing.invoices.retrieve`"
          }
        },
        {
          "name": "Listar facturas",
          "id": "invoices-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoices",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoices"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Estado.",
                  "disabled": true
                },
                {
                  "key": "customer",
                  "value": "",
                  "description": "Id del cliente.",
                  "disabled": true
                },
                {
                  "key": "subscription",
                  "value": "",
                  "description": "Id de la suscripción.",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.invoices.list`"
          }
        },
        {
          "name": "Consultar una factura",
          "id": "invoices-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoices/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoices",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.invoices.retrieve`"
          }
        },
        {
          "name": "Cobrar una factura ahora",
          "id": "invoices-pay",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoices/:id/pay",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoices",
                ":id",
                "pay"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Reintenta el cobro de inmediato con el método de la suscripción. 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és.\n\n**Permiso:** `billing.invoices.pay`"
          }
        },
        {
          "name": "Anular una factura",
          "id": "invoices-void",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoices/:id/void",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoices",
                ":id",
                "void"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Solo `draft` u `open`; emite `invoice.voided`.\n\n**Permiso:** `billing.invoices.void`"
          }
        },
        {
          "name": "Registrar un pago manual",
          "id": "invoices-mark-paid",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/invoices/:id/mark_paid",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "invoices",
                ":id",
                "mark_paid"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "La factura se pagó por fuera de Wompi (una transferencia): queda pagada con su referencia (única entre tus pagos manuales), como un pago `source: manual`, y la suscripción sigue como con cualquier pago — paga el periodo debido o activa la suscripción. Su reembolso solo se registra.\n\n**Permiso:** `billing.invoices.mark_paid`\n\n**Cuerpo:**\n- `reference` (string, obligatorio): Referencia de la transferencia.\n- `reason` (string): Nota (queda en la bitácora).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"reference\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Pagos",
      "description": "Cada intento de cobro en Wompi.",
      "item": [
        {
          "name": "Listar pagos",
          "id": "payments-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payments",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payments"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "invoice",
                  "value": "",
                  "description": "Id de la factura.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Estado.",
                  "disabled": true
                }
              ]
            },
            "description": "Cada intento de cobro enviado a Wompi, aprobado o no.\n\n**Permiso:** `billing.payments.list`"
          }
        },
        {
          "name": "Consultar un pago",
          "id": "payments-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payments/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payments",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.payments.retrieve`"
          }
        },
        {
          "name": "Reembolsar un pago",
          "id": "payments-refund",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payments/:id/refund",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payments",
                ":id",
                "refund"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "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ún 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ón (motivo `refunded`). Un pago manual se reembolsa solo registrado.\n\n**Permiso:** `billing.payments.refund`\n\n**Cuerpo:**\n- `amount` (integer): Pesos a devolver (por defecto, todo lo que queda).\n- `reason` (string): Motivo.\n- `cancel_subscription` (boolean): Cancelar la suscripción al quedar hecho."
          }
        },
        {
          "name": "Anular un pago",
          "id": "payments-void",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payments/:id/void",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payments",
                ":id",
                "void"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Anula en Wompi un cobro con tarjeta aprobado HOY (hora de Bogotá), completo y sin reembolsos; si no, reembólsalo. El pago y su factura quedan anulados. Responde el `refund` (`kind: void`).\n\n**Permiso:** `billing.payments.refund`\n\n**Cuerpo:**\n- `reason` (string): Motivo.\n- `cancel_subscription` (boolean): Cancelar la suscripción al quedar hecha."
          }
        }
      ]
    },
    {
      "name": "Cupones",
      "description": "Descuentos para tus suscripciones.",
      "item": [
        {
          "name": "Crear un cupón",
          "id": "coupons-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/coupons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "coupons"
              ]
            },
            "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ón, con sus reintentos); los prorrateos, el excedente y los pagos únicos van a precio de lista. Si el total con descuento queda bajo el mínimo de Wompi, el periodo pasa gratis. Una vez aplicado a una suscripción, sus términos no cambian.\n\n**Permiso:** `billing.coupons.create`\n\n**Cuerpo:**\n- `name` (string, obligatorio): Nombre.\n- `percent_off` (number): Porcentaje, de 0,01 a 100 (o `amount_off`).\n- `amount_off` (integer): Valor por periodo, en la unidad de `currency` (o `percent_off`).\n- `currency` (enum): Con `amount_off` (por defecto `COP`).\n- `duration` (enum, obligatorio): Duración.\n- `duration_in_months` (integer): Con `repeating`, de 1 a 120.\n- `applies_to` (enum): Por defecto `all`.\n- `max_redemptions` (integer): Tope de suscripciones.\n- `redeem_by` (datetime): Fecha límite para aplicarlo.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"name\": \"…\",\n  \"duration\": \"once\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar cupones",
          "id": "coupons-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/coupons",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "coupons"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                }
              ]
            },
            "description": "Los que no se han eliminado, del más reciente al más antiguo.\n\n**Permiso:** `billing.coupons.list`"
          }
        },
        {
          "name": "Consultar un cupón",
          "id": "coupons-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/coupons/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "coupons",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.coupons.retrieve`"
          }
        },
        {
          "name": "Editar un cupón",
          "id": "coupons-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/coupons/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "coupons",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Nombre, `active`, `max_redemptions`, `redeem_by` y metadata. El descuento, la moneda, la duración y `applies_to` solo mientras no se haya aplicado (`coupon_terms_frozen` después: crea otro).\n\n**Permiso:** `billing.coupons.update`\n\n**Cuerpo:**\n- `name` (string): Nombre.\n- `active` (boolean): `false`: no se aplica a nadie más.\n- `max_redemptions` (integer): Tope de suscripciones.\n- `redeem_by` (datetime): Fecha límite.\n- `percent_off` (number): Solo sin usos.\n- `amount_off` (integer): Solo sin usos.\n- `currency` (enum): Solo sin usos.\n- `duration` (enum): Solo sin usos.\n- `duration_in_months` (integer): Solo sin usos.\n- `applies_to` (enum): Solo sin usos.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Eliminar un cupón",
          "id": "coupons-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/coupons/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "coupons",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "No se aplica a nadie más; los descuentos ya aplicados siguen.\n\n**Permiso:** `billing.coupons.destroy`"
          }
        }
      ]
    },
    {
      "name": "Reembolsos",
      "description": "El dinero que devuelves.",
      "item": [
        {
          "name": "Listar reembolsos",
          "id": "refunds-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/refunds",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "refunds"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "payment",
                  "value": "",
                  "description": "Id del pago.",
                  "disabled": true
                },
                {
                  "key": "invoice",
                  "value": "",
                  "description": "Id de la factura.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Estado.",
                  "disabled": true
                }
              ]
            },
            "description": "Reembolsos y anulaciones, del más reciente al más antiguo.\n\n**Permiso:** `billing.refunds.list`"
          }
        },
        {
          "name": "Consultar un reembolso",
          "id": "refunds-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/refunds/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "refunds",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.refunds.retrieve`"
          }
        }
      ]
    },
    {
      "name": "Plazo fijo",
      "description": "Un plan pagado una vez, por días.",
      "item": [
        {
          "name": "Crear una oferta de plazo fijo",
          "id": "fixed-term-offers-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/fixed_term_offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "fixed_term_offers"
              ]
            },
            "description": "Un paquete único 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ía al cliente por correo. Pagado, la suscripción queda activa esos días 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 «por devolver» y se te avisa. Una oferta abierta por cliente.\n\n**Permiso:** `billing.fixed_term_offers.create`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Id del cliente.\n- `items` (array, obligatorio): `[{price, quantity}]`: el plan base primero, luego los adicionales.\n- `units` (array): `[{meter, units}]`: la clave del medidor y las unidades para todo el plazo.\n- `days` (integer, obligatorio): Días del plazo.\n- `amount` (integer, obligatorio): Precio en pesos (desde el mínimo de Wompi).\n- `name` (string): Nombre (por defecto «<plan> por N días»).\n- `link_days` (integer): Días que vive el link de pago, de 1 a 30.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\",\n  \"items\": [],\n  \"days\": 0,\n  \"amount\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar ofertas de plazo fijo",
          "id": "fixed-term-offers-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/fixed_term_offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "fixed_term_offers"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "customer",
                  "value": "",
                  "description": "Id del cliente.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Estado.",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.fixed_term_offers.list`"
          }
        },
        {
          "name": "Consultar una oferta de plazo fijo",
          "id": "fixed-term-offers-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/fixed_term_offers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "fixed_term_offers",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `billing.fixed_term_offers.retrieve`"
          }
        },
        {
          "name": "Cancelar una oferta de plazo fijo",
          "id": "fixed-term-offers-cancel",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/fixed_term_offers/:id/cancel",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "fixed_term_offers",
                ":id",
                "cancel"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Solo una que espera el pago; su link de pago deja de funcionar.\n\n**Permiso:** `billing.fixed_term_offers.cancel`"
          }
        }
      ]
    },
    {
      "name": "Eventos",
      "description": "Cada cambio, consultable 30 días.",
      "item": [
        {
          "name": "Listar eventos",
          "id": "events-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/events",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "events"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "",
                  "description": "Un tipo (`invoice.paid`) o un grupo (`invoice.*`).",
                  "disabled": true
                }
              ]
            },
            "description": "Los de los últimos 30 días, del más reciente al más antiguo. Se ordenan por el momento en que se crearon, y un evento puede aparecer en la lista un instante después que otro más reciente (se confirma más tarde). Si sigues los nuevos con `ending_before`, no uses como cursor el último 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.\n\n**Permiso:** `webhooks.events.list`"
          }
        },
        {
          "name": "Consultar un evento",
          "id": "events-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/events/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "events",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `webhooks.events.retrieve`"
          }
        },
        {
          "name": "Reenviar un evento",
          "id": "events-resend",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/events/:id/resend",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "events",
                ":id",
                "resend"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Lo entrega otra vez, con el mismo `id`, a tus endpoints activos que lo escuchan, o solo a `webhook_endpoint` (aunque esté desactivado). Requiere un plan con webhooks.\n\n**Permiso:** `webhooks.events.resend`\n\n**Cuerpo:**\n- `webhook_endpoint` (string): Id de un endpoint (`we_…`)."
          }
        }
      ]
    },
    {
      "name": "Webhooks",
      "description": "Dónde te avisamos de los eventos.",
      "item": [
        {
          "name": "Crear un endpoint de webhook",
          "id": "webhook-endpoints-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook_endpoints",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook_endpoints"
              ]
            },
            "description": "La respuesta trae `secret` (`whsec_…`) **una sola vez**: guárdalo para verificar las firmas (si repites la petición con la misma `Idempotency-Key` responde `409 webhook_secret_unavailable_on_replay`, nunca el secreto). La URL debe ser HTTPS y pública. En producción el propietario de la cuenta recibe un correo con la URL. Desde el dashboard, un endpoint de producción lo crea solo el propietario o un administrador (`webhooks.webhook_endpoints.manage_live`) y pide confirmar la identidad (`password` o `code` en el cuerpo).\n\n**Permiso:** `webhooks.webhook_endpoints.create`\n\n**Cuerpo:**\n- `url` (string, obligatorio): URL HTTPS.\n- `enabled_events` (array, obligatorio): Tipos de evento, o `[\"*\"]`.\n- `description` (string): Para qué es.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"url\": \"…\",\n  \"enabled_events\": []\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar endpoints de webhook",
          "id": "webhook-endpoints-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook_endpoints",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook_endpoints"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `webhooks.webhook_endpoints.list`"
          }
        },
        {
          "name": "Consultar un endpoint de webhook",
          "id": "webhook-endpoints-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook_endpoints/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook_endpoints",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Nunca trae el secreto.\n\n**Permiso:** `webhooks.webhook_endpoints.retrieve`"
          }
        },
        {
          "name": "Actualizar un endpoint de webhook",
          "id": "webhook-endpoints-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook_endpoints/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook_endpoints",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "`disabled: true` lo desactiva (sus entregas pendientes se omiten); `false` lo reactiva. Si cambia la `url` de un endpoint de producción, 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.\n\n**Permiso:** `webhooks.webhook_endpoints.update`\n\n**Cuerpo:**\n- `url` (string): URL HTTPS.\n- `enabled_events` (array): Tipos de evento.\n- `description` (string): Para qué es.\n- `disabled` (boolean): Desactivar o reactivar.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Eliminar un endpoint de webhook",
          "id": "webhook-endpoints-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook_endpoints/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook_endpoints",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `webhooks.webhook_endpoints.destroy`"
          }
        },
        {
          "name": "Regenerar el secreto de firma",
          "id": "webhook-endpoints-roll-secret",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/webhook_endpoints/:id/roll_secret",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "webhook_endpoints",
                ":id",
                "roll_secret"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Responde el secreto nuevo una sola vez. Durante 24 horas cada entrega trae dos firmas `v1` en `Bucli-Signature` —la del secreto anterior y, la última, la del nuevo—: acepta la entrega si cualquiera coincide y despliega el nuevo secreto en ese plazo; después solo firma el nuevo.\n\n**Permiso:** `webhooks.webhook_endpoints.roll_secret`"
          }
        }
      ]
    },
    {
      "name": "Cuenta",
      "description": "Tu comercio en la API.",
      "item": [
        {
          "name": "Consultar la cuenta",
          "id": "account-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/account",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "account"
              ]
            },
            "description": "Tu comercio como lo ve la API en el modo de la llave.\n\n**Permiso:** `developers.account.retrieve`"
          }
        }
      ]
    },
    {
      "name": "Checkout",
      "description": "La página de pago hospedada.",
      "item": [
        {
          "name": "Crear una sesión de checkout",
          "id": "checkout-sessions-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout_sessions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout_sessions"
              ]
            },
            "description": "Responde la `url` de la página de pago hospedada (`pay.bucli.co/c/…`): redirige a tu cliente ahí. Ahí ve el plan con tu marca, acepta los términos 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ón, y vuelve a `success_url` con `?session_id=cs_…`. Vence en 24 horas. Con `line_items` la página muestra cada línea y el total, y la suscripción nace con esos ítems. Una llave publicable (`pk_`) también la crea desde el navegador, pero sin `customer`, `trial_days`, `customer_fields`, `client_reference_id`, `metadata` ni `subscription_data` (`403 secret_key_required`).\n\n**Permiso:** `checkout.checkout_sessions.create`\n**Llave publicable:** sí (`pk_`).\n\n**Cuerpo:**\n- `price` (string): Precio que se suscribe (`price_…`); o `line_items`.\n- `quantity` (integer): Cantidad del `price` (1–10.000, por defecto 1); no con `line_items`.\n- `line_items` (array): `[{price, quantity}]`: el plan base, los puestos y los adicionales, en orden (el primero es el `price` del objeto). Una sola línea 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.\n- `success_url` (string, obligatorio): A dónde vuelve al terminar (https en producción).\n- `cancel_url` (string): A dónde vuelve si se arrepiente.\n- `customer` (string): Cliente existente (`cus_…`); no con una llave `pk_`.\n- `customer_email` (string): Correo del cliente, fijo en la página (en vez de `customer`).\n- `customer_fields` (array): Datos a pedir además del correo (por defecto `[\"name\"]`).\n- `trial_days` (integer): Días de prueba (0–730); por defecto los del precio.\n- `client_reference_id` (string): Tu referencia, para reconocer la sesión en el webhook.\n- `subscription_data` (object): Lo que lleva la suscripción que se crea: `metadata` (hasta 20 pares) y `trial_days` (lo mismo que `trial_days`; si envías los dos deben coincidir). No con una llave `pk_`.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"success_url\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Consultar una sesión de checkout",
          "id": "checkout-sessions-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout_sessions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout_sessions",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Úsala al volver a tu `success_url` para saber qué suscripción quedó creada.\n\n**Permiso:** `checkout.checkout_sessions.retrieve`"
          }
        },
        {
          "name": "Vencer una sesión de checkout",
          "id": "checkout-sessions-expire",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/checkout_sessions/:id/expire",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "checkout_sessions",
                ":id",
                "expire"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Cierra una sesión abierta: su página ya no recibe pagos y se emite `checkout.session.expired`. Una sesión completada, vencida o con un cobro esperando respuesta de Wompi responde `409 checkout_session_not_expirable`.\n\n**Permiso:** `checkout.checkout_sessions.expire`"
          }
        }
      ]
    },
    {
      "name": "Enlaces de pago",
      "description": "Vender un plan sin código.",
      "item": [
        {
          "name": "Crear un enlace de pago",
          "id": "payment-links-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_links",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_links"
              ]
            },
            "description": "Una URL pública (`pay.bucli.co/l/…`) para vender un plan sin código, por WhatsApp o Instagram: cada visita abre un checkout nuevo con sus líneas (`price` o `line_items`).\n\n**Permiso:** `checkout.payment_links.create`\n\n**Cuerpo:**\n- `price` (string): Precio que vende (`price_…`); o `line_items`.\n- `quantity` (integer): Cantidad del `price` (1–10.000, por defecto 1); no con `line_items`.\n- `line_items` (array): `[{price, quantity}]`: el plan base, los puestos y los adicionales, en orden (el primero es el `price` del objeto). Una sola línea 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.\n- `customer_fields` (array): Datos a pedir además del correo.\n- `trial_days` (integer): Días de prueba (0–730); por defecto los del precio.\n- `success_url` (string): A dónde vuelve el cliente al terminar.\n- `active` (boolean): Activo (por defecto `true`).\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Listar enlaces de pago",
          "id": "payment-links-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_links",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_links"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "active",
                  "value": "",
                  "description": "Solo activos o inactivos.",
                  "disabled": true
                },
                {
                  "key": "price",
                  "value": "",
                  "description": "Solo de un precio.",
                  "disabled": true
                }
              ]
            },
            "description": "Del más reciente al más antiguo.\n\n**Permiso:** `checkout.payment_links.list`"
          }
        },
        {
          "name": "Consultar un enlace de pago",
          "id": "payment-links-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_links/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_links",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Con cuántos checkouts abrió.\n\n**Permiso:** `checkout.payment_links.retrieve`"
          }
        },
        {
          "name": "Actualizar un enlace de pago",
          "id": "payment-links-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/payment_links/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "payment_links",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Desactívalo (`active: false`) para que deje de abrir checkouts; el precio y las líneas no cambian: crea otro enlace.\n\n**Permiso:** `checkout.payment_links.update`\n\n**Cuerpo:**\n- `active` (boolean): Activo.\n- `customer_fields` (array): Datos a pedir además del correo.\n- `trial_days` (integer): Días de prueba.\n- `success_url` (string): A dónde vuelve el cliente al terminar.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        }
      ]
    },
    {
      "name": "Portal del cliente",
      "description": "Donde tu cliente administra lo suyo.",
      "item": [
        {
          "name": "Crear una sesión del portal",
          "id": "portal-sessions-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/portal_sessions",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "portal_sessions"
              ]
            },
            "description": "Responde la `url` del portal del cliente (`portal.bucli.co/s/…`), válida una hora: ahí ve sus suscripciones y su próximo cobro, cancela al fin del periodo, cambia la tarjeta (si debía, se cobra de inmediato), descarga sus recibos y edita sus datos, según lo que permitas en «Portal y marca». La `url` solo se responde al crearla: si la respuesta se perdió y repites la petición con la misma `Idempotency-Key`, responde `409 url_unavailable_on_replay` (con `error.object_id`); crea otra sesión con una clave nueva.\n\n**Permiso:** `checkout.portal_sessions.create`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Cliente (`cus_…`).\n- `return_url` (string): A dónde vuelve; por defecto la de «Portal y marca».",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Consultar una sesión del portal",
          "id": "portal-sessions-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/portal_sessions/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "portal_sessions",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Para qué cliente es y hasta cuándo 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ón.\n\n**Permiso:** `checkout.portal_sessions.retrieve`"
          }
        }
      ]
    },
    {
      "name": "Derechos",
      "description": "Tu vocabulario de módulos y límites.",
      "item": [
        {
          "name": "Crear un derecho",
          "id": "features-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/features",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "features"
              ]
            },
            "description": "Una clave de tu vocabulario: un módulo (`boolean`) o un límite (`limit`, `static` o `metered`). Bucli no conoce ninguna de antemano: tus productos dicen cuáles dan (`entitlements`).\n\n**Permiso:** `entitlements.features.create`\n\n**Cuerpo:**\n- `key` (string, obligatorio): Minúsculas, números y `_`, empieza por letra (máximo 50). No cambia.\n- `name` (string, obligatorio): Nombre.\n- `type` (enum, obligatorio): `boolean` o `limit`.\n- `limit_kind` (enum): De un límite: `static` o `metered`.\n- `allows_unlimited` (boolean): De un límite: `false` = nunca ilimitado (por defecto `true`).\n- `description` (string): Descripción.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"…\",\n  \"name\": \"…\",\n  \"type\": \"boolean\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar los derechos",
          "id": "features-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/features",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "features"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "type",
                  "value": "",
                  "description": "Solo módulos o solo límites.",
                  "disabled": true
                },
                {
                  "key": "key",
                  "value": "",
                  "description": "Clave exacta.",
                  "disabled": true
                }
              ]
            },
            "description": "Tu vocabulario, por clave.\n\n**Permiso:** `entitlements.features.list`"
          }
        },
        {
          "name": "Consultar un derecho",
          "id": "features-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/features/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "features",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `entitlements.features.retrieve`"
          }
        },
        {
          "name": "Actualizar un derecho",
          "id": "features-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/features/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "features",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "El nombre, la descripción, la metadata y si un límite 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`.\n\n**Permiso:** `entitlements.features.update`\n\n**Cuerpo:**\n- `name` (string): Nombre.\n- `description` (string): Descripción.\n- `allows_unlimited` (boolean): Solo de un límite.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Eliminar un derecho",
          "id": "features-delete",
          "request": {
            "method": "DELETE",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/features/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "features",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Solo uno que nada usa: ni un producto, ni un ajuste, ni un medidor (`422 feature_in_use`).\n\n**Permiso:** `entitlements.features.destroy`"
          }
        }
      ]
    },
    {
      "name": "Derechos de los clientes",
      "description": "Qué tiene cada cliente y su acceso.",
      "item": [
        {
          "name": "Consultar los derechos de una suscripción",
          "id": "subscriptions-entitlements",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/entitlements",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "entitlements"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Lo que dan sus productos combinados (módulos unidos, límites 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ías de gracia), `read_only` pausada, cancelada o pasada la gracia (con `read_only_reason`), `none` si nunca se pagó. Cada cambio llega como `entitlements.updated`.\n\n**Permiso:** `entitlements.entitlements.retrieve`"
          }
        },
        {
          "name": "Ajustar los derechos de una suscripción",
          "id": "subscriptions-entitlement-overrides",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/subscriptions/:id/entitlement_overrides",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "subscriptions",
                ":id",
                "entitlement_overrides"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Tus ajustes a mano, completos (lo que no envíes se quita; un cuerpo vacío los borra): `features_add`, `features_remove` (gana sobre el plan) y `limits` (un mínimo: se toma el mayor entre el plan y el ajuste; `-1` gana). Se conservan en cada recálculo. Si el cliente compra un producto que da un módulo que quitaste a mano, la compra levanta esa restricción. Con `keep_current: true` y `price` (el plan al que baja; sin él, su `pending_price`) convierte en ajustes lo que hoy tiene de más sobre ese plan: úsalo antes de bajarlo de plan para no quitarle nada. Responde sus derechos ya recalculados.\n\n**Permiso:** `entitlements.overrides.update`\n\n**Cuerpo:**\n- `features_add` (array): Módulos que se suman.\n- `features_remove` (array): Módulos que se quitan.\n- `limits` (object): `{clave: número}` mínimos; `-1` = ilimitado.\n- `note` (string): Por qué (hasta 500 caracteres).\n- `keep_current` (boolean): Convertir lo que tiene de más en ajustes (con `price` y `note`).\n- `price` (string): Con `keep_current`: el precio del plan al que baja (por defecto su `pending_price`)."
          }
        },
        {
          "name": "Consultar los derechos de un cliente",
          "id": "customers-entitlements",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/customers/:id/entitlements",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "customers",
                ":id",
                "entitlements"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Sus suscripciones con acceso completo combinadas (módulos unidos, límites sumados); si no tiene ninguna, habla la más reciente en solo lectura; si no tiene suscripciones, `access: none`. Es lo que cuentan los medidores del cliente.\n\n**Permiso:** `entitlements.entitlements.retrieve`"
          }
        }
      ]
    },
    {
      "name": "Medidores",
      "description": "Cupos por ventana.",
      "item": [
        {
          "name": "Crear un medidor",
          "id": "meters-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/meters",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "meters"
              ]
            },
            "description": "Cuenta un límite `metered` de tu vocabulario con la misma `key`: el cupo de cada ventana es ese límite en los derechos del cliente (plan + bloques recurrentes); las bolsas cubren lo que pase de ahí.\n\n**Permiso:** `entitlements.meters.create`\n\n**Cuerpo:**\n- `key` (string, obligatorio): Clave del límite medido.\n- `name` (string, obligatorio): Nombre.\n- `window` (enum): Por defecto `calendar_month`. No cambia.\n- `timezone` (string): Por defecto `America/Bogota`. No cambia.\n- `on_unavailable` (enum): Por defecto `deny`.\n- `threshold_percent` (integer): Aviso al (por defecto 80).\n- `active` (boolean): Por defecto `true`.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"key\": \"…\",\n  \"name\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar medidores",
          "id": "meters-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/meters",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "meters"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `entitlements.meters.list`"
          }
        },
        {
          "name": "Consultar un medidor",
          "id": "meters-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/meters/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "meters",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "`{id}` es el id (`mtr_…`) o la clave (`documents`).\n\n**Permiso:** `entitlements.meters.retrieve`"
          }
        },
        {
          "name": "Actualizar un medidor",
          "id": "meters-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/meters/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "meters",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "El nombre, `on_unavailable`, el aviso, si está activo y la metadata. La clave, la ventana y la zona no cambian.\n\n**Permiso:** `entitlements.meters.update`\n\n**Cuerpo:**\n- `name` (string): Nombre.\n- `on_unavailable` (enum): `allow` o `deny`.\n- `threshold_percent` (integer): Aviso al.\n- `active` (boolean): Activo.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Consultar el uso de un cliente",
          "id": "meters-summary",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/meters/:id/summary",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "meters",
                ":id",
                "summary"
              ],
              "query": [
                {
                  "key": "customer",
                  "value": "",
                  "description": "Id del cliente.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "La ventana en curso: cupo, usado, lo que queda y las bolsas vivas con su saldo y vencimiento. Es la pantalla «Uso».\n\n**Permiso:** `entitlements.meters.retrieve`"
          }
        }
      ]
    },
    {
      "name": "Consumo",
      "description": "Reservar, reportar y devolver unidades.",
      "item": [
        {
          "name": "Reservar unidades",
          "id": "meters-reserve",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/meters/:id/reserve",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "meters",
                ":id",
                "reserve"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "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) — 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árdalo 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é en solo lectura: es el consumo de tus clientes.\n\n**Permiso:** `entitlements.usage.create`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Id del cliente.\n- `idempotency_key` (string, obligatorio): Tu llave única por unidad (hasta 255).\n- `quantity` (integer): Unidades (por defecto 1).\n- `billable` (boolean): `false`: se registra sin gastar cupo.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\",\n  \"idempotency_key\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Reportar consumo tardío",
          "id": "usage-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/usage",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "usage"
              ]
            },
            "description": "Lo que tu librería dejó pasar mientras Bucli no respondía (`on_unavailable: allow`): se asienta en la ventana en que ocurrió 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ás de 35 días.\n\n**Permiso:** `entitlements.usage.create`\n\n**Cuerpo:**\n- `meter` (string, obligatorio): Id o clave del medidor.\n- `customer` (string, obligatorio): Id del cliente.\n- `idempotency_key` (string, obligatorio): La misma llave que habrías usado al reservar.\n- `occurred_at` (datetime, obligatorio): Cuándo pasó.\n- `quantity` (integer): Unidades (por defecto 1).\n- `billable` (boolean): `false`: sin gastar cupo.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"meter\": \"…\",\n  \"customer\": \"…\",\n  \"idempotency_key\": \"…\",\n  \"occurred_at\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar el consumo",
          "id": "usage-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/usage",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "usage"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "meter",
                  "value": "",
                  "description": "Clave del medidor.",
                  "disabled": true
                },
                {
                  "key": "customer",
                  "value": "",
                  "description": "Id del cliente.",
                  "disabled": true
                }
              ]
            },
            "description": "Del más reciente al más antiguo.\n\n**Permiso:** `entitlements.usage.list`"
          }
        },
        {
          "name": "Consultar un consumo",
          "id": "usage-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/usage/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "usage",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `entitlements.usage.retrieve`"
          }
        },
        {
          "name": "Devolver un consumo",
          "id": "usage-release",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/usage/:id/release",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "usage",
                ":id",
                "release"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Cada unidad vuelve a SU origen (el cupo de su ventana o la bolsa de la que salió), una sola vez: una segunda llamada responde el consumo tal como está. Para un documento rechazado, un borrador borrado o un envío que no salió.\n\n**Permiso:** `entitlements.usage.release`"
          }
        }
      ]
    },
    {
      "name": "Ofertas de bolsas",
      "description": "Paquetes de unidades que vendes.",
      "item": [
        {
          "name": "Crear una oferta de bolsa",
          "id": "grant-offers-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grant_offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grant_offers"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ]
            },
            "description": "Un paquete de unidades que vendes (20, 100, 500…), con un precio de pago único (`type: one_time`) de un producto tuyo: así la factura electrónica usa su producto enlazado.\n\n**Permiso:** `entitlements.grant_offers.create`\n\n**Cuerpo:**\n- `meter` (string, obligatorio): Id o clave del medidor.\n- `price` (string, obligatorio): Precio de pago único (`price_…`).\n- `name` (string, obligatorio): Nombre.\n- `units` (integer, obligatorio): Unidades.\n- `validity_months` (integer): Vigencia desde el pago (por defecto 12; 0 = no vence).\n- `requires_features` (array): Solo para clientes con alguno de estos módulos.\n- `active` (boolean): Por defecto `true`.\n- `position` (integer): Orden.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"meter\": \"…\",\n  \"price\": \"…\",\n  \"name\": \"…\",\n  \"units\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar las ofertas de bolsas",
          "id": "grant-offers-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grant_offers",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grant_offers"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "meter",
                  "value": "",
                  "description": "Clave del medidor.",
                  "disabled": true
                },
                {
                  "key": "active",
                  "value": "",
                  "description": "Activas o no.",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `entitlements.grant_offers.list`"
          }
        },
        {
          "name": "Consultar una oferta de bolsa",
          "id": "grant-offers-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grant_offers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grant_offers",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `entitlements.grant_offers.retrieve`"
          }
        },
        {
          "name": "Actualizar una oferta de bolsa",
          "id": "grant-offers-update",
          "request": {
            "method": "PATCH",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grant_offers/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grant_offers",
                ":id"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "El nombre, los módulos que exige, el orden, si está activa y la metadata. Unidades, precio y vigencia no cambian: crea otra oferta.\n\n**Permiso:** `entitlements.grant_offers.update`\n\n**Cuerpo:**\n- `name` (string): Nombre.\n- `requires_features` (array): Módulos que exige.\n- `active` (boolean): Archivar o reactivar.\n- `position` (integer): Orden.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave."
          }
        },
        {
          "name": "Vender una bolsa",
          "id": "grant-offers-purchase",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grant_offers/:id/purchase",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grant_offers",
                ":id",
                "purchase"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Crea una factura única 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ía dos veces).\n\n**Permiso:** `entitlements.grant_offers.purchase`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Id del cliente.\n- `payment_method` (string): Tarjeta del cliente (por defecto, la predeterminada).",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\"\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        }
      ]
    },
    {
      "name": "Bolsas",
      "description": "Unidades prepagadas de cada cliente.",
      "item": [
        {
          "name": "Regalar una bolsa",
          "id": "grants-create",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              },
              {
                "key": "Content-Type",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grants",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grants"
              ]
            },
            "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`.\n\n**Permiso:** `entitlements.grants.create`\n\n**Cuerpo:**\n- `customer` (string, obligatorio): Id del cliente.\n- `meter` (string, obligatorio): Id o clave del medidor.\n- `units` (integer, obligatorio): Unidades.\n- `remaining` (integer): Lo que le queda (por defecto todas).\n- `expires_at` (datetime): Vencimiento (futuro); sin él no vence.\n- `note` (string): Por qué.\n- `imported` (boolean): Viene de tu sistema anterior.\n- `metadata` (object): Hasta 20 pares de texto (claves ≤ 40, valores ≤ 500). En un PATCH se combinan; `\"\"` borra una clave.",
            "body": {
              "mode": "raw",
              "raw": "{\n  \"customer\": \"…\",\n  \"meter\": \"…\",\n  \"units\": 0\n}",
              "options": {
                "raw": {
                  "language": "json"
                }
              }
            }
          }
        },
        {
          "name": "Listar las bolsas",
          "id": "grants-list",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grants",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grants"
              ],
              "query": [
                {
                  "key": "limit",
                  "value": "",
                  "description": "Cuántos objetos, de 1 a 100 (por defecto 10).",
                  "disabled": true
                },
                {
                  "key": "starting_after",
                  "value": "",
                  "description": "Id del último objeto de la página anterior: trae la siguiente.",
                  "disabled": true
                },
                {
                  "key": "ending_before",
                  "value": "",
                  "description": "Id del primer objeto de la página actual: trae la anterior.",
                  "disabled": true
                },
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`data.customer`): hasta 4 caminos de hasta 4 niveles; cuentan más en el límite de uso.",
                  "disabled": true
                },
                {
                  "key": "customer",
                  "value": "",
                  "description": "Id del cliente.",
                  "disabled": true
                },
                {
                  "key": "meter",
                  "value": "",
                  "description": "Clave del medidor.",
                  "disabled": true
                },
                {
                  "key": "status",
                  "value": "",
                  "description": "Estado.",
                  "disabled": true
                }
              ]
            },
            "description": "\n\n**Permiso:** `entitlements.grants.list`"
          }
        },
        {
          "name": "Consultar una bolsa",
          "id": "grants-retrieve",
          "request": {
            "method": "GET",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grants/:id",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grants",
                ":id"
              ],
              "query": [
                {
                  "key": "expand[]",
                  "value": "",
                  "description": "Objetos relacionados a incluir completos (`customer`): hasta 4 caminos de hasta 4 niveles.",
                  "disabled": true
                }
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "\n\n**Permiso:** `entitlements.grants.retrieve`"
          }
        },
        {
          "name": "Retirar una bolsa",
          "id": "grants-withdraw",
          "request": {
            "method": "POST",
            "header": [
              {
                "key": "Accept",
                "value": "application/json"
              }
            ],
            "url": {
              "raw": "{{baseUrl}}/grants/:id/withdraw",
              "host": [
                "{{baseUrl}}"
              ],
              "path": [
                "grants",
                ":id",
                "withdraw"
              ],
              "variable": [
                {
                  "key": "id",
                  "value": "",
                  "description": "Id del objeto (`cus_…`, `sub_…`)."
                }
              ]
            },
            "description": "Le quita lo que le queda a una bolsa vigente (un reembolso total, un error). Emite `grant.withdrawn`.\n\n**Permiso:** `entitlements.grants.withdraw`\n\n**Cuerpo:**\n- `note` (string): Por qué."
          }
        }
      ]
    }
  ]
}