Cobrar el cargo por inasistencia
Cobra el cargo por inasistencia a la tarjeta que el cliente dejó al
reservar (política card_on_file), dentro del plazo del negocio después
de marcar la cita como no_show. Nunca es automático. Si el banco lo
rechaza responde 422 con code: declined y la cita conserva
no_show_fee_checkout_id; su link permite pagar con otra tarjeta. Un
cargo todavía en proceso responde code: pending y bloquea un segundo
cargo. Requiere que la llave pueda mover dinero.
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.
Path parameters
Response
Cuenta (sucursal) de la cita.
pending mientras el cliente paga o el negocio decide; confirmed cuando la hora es del cliente.
Por dónde entró la reserva.
Los tramos de la cita, uno por servicio (dos si el servicio tiene tiempo de proceso). Vacío en un lugar de una clase.
La sesión, si la cita es un lugar en una clase.
Las noches en una habitación, si la reserva es una estadía de alojamiento.
Lo que el cliente ya pagó (anticipo, total o protección).
Lo que falta cobrar el día de la cita. 0 en una sesión de paquete o un saldo cobrado afuera.
Cuándo el negocio marcó el saldo como cobrado fuera de Recurrente.
Donde el cliente paga lo que la política pide, o deja su tarjeta.
El link del saldo, después de POST /bookings/{booking_id}/balance_charge.
La serie que la reservó, si se repite.
La página del cliente para ver, pagar o cancelar su cita (link firmado).
Hasta cuándo se aparta la hora si nadie paga.
La cita que esta reemplazó al moverse de hora.