Cambiar las políticas de Citas
Cambia solo los campos que envías, con las mismas validaciones del
panel. Los interruptores (allow_customer_cancel, deposit_refundable,
multiple_services, multiple_staff) toman true o false; un campo
en null vuelve a su valor vacío. Con default_payment_policy: card_on_file el cargo por inasistencia es obligatorio
(no_show_fee_amount_in_cents, o no_show_fee_percent con
no_show_fee_kind: percent). Un valor inválido responde 422 con
code: invalid_booking_settings y los mensajes del panel.
Authentication
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.
Request
Anticipación mínima para reservar, en minutos (0 a 40,320).
Hasta cuántos días adelante se puede reservar (1 a 365).
Cada cuánto empiezan los horarios; service los separa por la duración de la cita.
Máximo de citas por día (por profesional o por cuenta); null sin límite.
Hasta cuántas horas antes puede cancelar o mover el cliente (0 a 336).
requires_acceptance: el negocio acepta cada cita a mano.
La protección de los servicios que no eligen la suya.
El cargo como porcentaje del precio (con no_show_fee_kind en percent).
Cuántos días después de la cita se puede cobrar la inasistencia (1 a 60).
La política que lee el cliente al reservar.
Response
Las políticas, ya guardadas
Anticipación mínima para reservar, en minutos (0 a 40,320).
Hasta cuántos días adelante se puede reservar (1 a 365).
Cada cuánto empiezan los horarios; service los separa por la duración de la cita.
Máximo de citas por día (por profesional o por cuenta); null sin límite.
Hasta cuántas horas antes puede cancelar o mover el cliente (0 a 336).
requires_acceptance: el negocio acepta cada cita a mano.
La protección de los servicios que no eligen la suya.
El cargo como porcentaje del precio (con no_show_fee_kind en percent).
Cuántos días después de la cita se puede cobrar la inasistencia (1 a 60).
La política que lee el cliente al reservar.