Listar las formas de vender

GET

https://app.recurrente.com/api/sales_channels

GET

/api/sales_channels

curl https://app.recurrente.com/api/sales_channels \
     -H "X-SECRET-KEY: <apiKey>" \
     -H "Content-Type: application/json"

200Retrieved

[
  {
    "key": "store",
    "name": "Tienda",
    "kind": "vertical",
    "parent": null,
    "on": true,
    "description": "Permite vender productos físicos y digitales a través de la plataforma.",
    "off_effect": "No se podrán procesar nuevas ventas ni gestionar inventarios.",
    "kept_commitments": "Las órdenes ya pagadas y en proceso seguirán su curso normal."
  },
  {
    "key": "citas",
    "name": "Citas",
    "kind": "vertical",
    "parent": null,
    "on": true,
    "description": "Agenda y gestión de citas para servicios con horarios definidos.",
    "off_effect": "No se podrán reservar nuevas citas ni modificar las existentes.",
    "kept_commitments": "Las citas confirmadas y pagadas se mantendrán activas hasta su finalización."
  },
  {
    "key": "lodging",
    "name": "Alojamiento",
    "kind": "vertical",
    "parent": null,
    "on": false,
    "description": "Gestión de reservas y pagos para servicios de alojamiento.",
    "off_effect": "No se podrán crear nuevas reservas ni gestionar disponibilidad.",
    "kept_commitments": "Reservas activas y pagos pendientes seguirán vigentes hasta su cierre."
  },
  {
    "key": "gift_cards",
    "name": "Tarjetas de regalo",
    "kind": "tool",
    "parent": "store",
    "on": true,
    "description": "Sistema para emitir y canjear tarjetas de regalo dentro de la tienda.",
    "off_effect": "No se podrán emitir nuevas tarjetas ni canjear las existentes.",
    "kept_commitments": "Tarjetas ya emitidas y activas seguirán siendo válidas hasta su vencimiento."
  },
  {
    "key": "contracts",
    "name": "Contratos",
    "kind": "tool",
    "parent": "citas",
    "on": false,
    "description": "Herramienta para gestionar contratos asociados a servicios y citas.",
    "off_effect": "No se podrán crear ni modificar contratos nuevos.",
    "kept_commitments": "Contratos vigentes y firmados seguirán siendo válidos y ejecutables."
  }
]

Las líneas de negocio que la cuenta puede tener (Tienda, Citas, Alojamiento, Tarjetas de regalo, Contratos), si están activas, qué deja de pasar al desactivar cada una y qué sigue funcionando. Es Configuración → Formas de vender.

Authentication

X-SECRET-KEYstring

Tu clave secreta de API.

Una llave de cuenta (sk_live_..., sk_test_...) opera sobre su propia cuenta y, con X-ACCOUNT-ID, sobre sus cuentas conectadas.

La llave también fija el ambiente: una sk_test_ solo lista y resuelve objetos de prueba (live_mode: false) y una sk_live_ solo objetos reales. Un ID del otro ambiente responde 404 (401 en /customers).

Una llave de organización (sk_org_live_..., sk_org_test_...) alcanza todas las cuentas de una organización y solo sirve para leer: saldos, movimientos y reportes. Para operar sobre una cuenta debe nombrarla con X-ACCOUNT-ID; omitirlo en una lectura devuelve todas las cuentas de la organización. Cualquier otro endpoint responde 403 con code: organization_key_unsupported.

Response

Las formas de vender

keyenumOptional

Allowed values:

namestringOptional

kindenumOptional

vertical se vende; tool acompaña a una (Tarjetas de regalo, Contratos).

Allowed values:

parentstring or nullOptional

La línea bajo la que va una herramienta.

onbooleanOptional

descriptionstringOptional

off_effectstringOptional

Qué deja de pasar al desactivarla.

kept_commitmentsstringOptional

Qué sigue funcionando después de desactivarla.