---
title: "Cobrar reservas desde otro punto de venta"
description: "Deja que un punto de venta externo lea lo que suma una reserva y devuelva la venta para que la reserva se complete."
url: "https://bookatu.com/es-es/help/checkout-from-an-outside-till"
language: "es"
section: "Ayuda"
category: "Desarrolladores"
published: "2026-10-28"
updated: "2026-11-18"
---

# Cobrar reservas desde otro punto de venta

Deja que un punto de venta externo lea lo que suma una reserva y devuelva la venta para que la reserva se complete.

## Qué es

El traspaso del cobro es una sola dirección con dos llamadas: GET y POST /api/v1/{slug}/appointments/{id}/checkout. GET devuelve lo que suma la reserva: cada servicio y extra con su lineId y quién lo hizo, el precio, los descuentos, las líneas de impuestos, el depósito ya pagado y dueCents, que es exactamente lo que hay que cobrar. POST registra la venta que cobró tu punto de venta, completa la reserva y le vincula la venta, usando el mismo código de cobro que el punto de venta propio de Bookatu.

## Por qué ayuda

Nadie tiene que registrar una visita dos veces, y la reserva, la venta, lo que se atribuye al personal y el dinero cuadran en Bookatu como si lo hubiera cobrado su propio punto de venta. El envío es idempotente según tu externalSaleId, así que un reintento después de una conexión caída devuelve replayed: true y no escribe nada.

## Cómo se usa

1. Los propietarios y los administradores crean la clave en Settings, luego API & monitoring, en API keys. En What this key may do, marca las dos casillas de la fila Checkout at another point of sale: See what a booking comes to at checkout (checkout:read) y Check bookings out from another point of sale (checkout:write). Hay que activarlas a propósito, y una clave creada antes de que existieran los permisos nunca las lleva. Quien crea la clave tiene que poder ver el calendario de todo el mundo (para checkout:read) y editar el calendario (para checkout:write). Añade See bookings (bookings:read) para listar las reservas del día con GET /appointments, y See clients (customers:read) si tu punto de venta necesita el nombre, el correo y el teléfono del cliente. Sin eso, el cliente llega solo con su id.
2. Envía la clave como Authorization: Bearer en cada llamada. Llama a GET /api/v1/{slug}/appointments/{id}/checkout y registra sus líneas en tu punto de venta. checkout.allowed dice si la reserva se puede cobrar ahora, y checkout.blocked da el motivo: not_live, deposit_pending, already_checked_out o invoiced. invoiced significa que la reserva está en una factura y se paga allí, así que no cobres por ella en tu punto de venta.
3. Cobra el dinero y después haz un POST a la misma dirección con { externalSaleId, source, amountCents, currency, tender, tipCents, tipSplit, lines }. externalSaleId es el id de venta propio de tu punto de venta. source nombra tu punto de venta, como front_desk_pos (por defecto es external y nunca puede ser bookatu). amountCents tiene que ser igual a dueCents. currency es opcional, pero tiene que ser la del negocio. tender es card, cash u other. lines, como [{ lineId, staffId }], atribuye una línea a otra persona.
4. Si envías otra vez el mismo externalSaleId desde el mismo punto de venta, se devuelve la venta original con replayed: true. Los rechazos no escriben nada y dan un motivo: 400 card_number (externalSaleId o source parece un número de tarjeta, que nunca se acepta); 409 amount_mismatch (con expectedCents), already_checked_out, external_sale_used, lines_changed (vuelve a leer el cobro), not_live, deposit_pending o invoiced (la reserva se paga en su factura); 422 currency o tip_split; 503 mientras el traspaso todavía se está activando para el negocio.
5. Para enterarte de cada cobro, añade un webhook en la tarjeta Webhooks de la misma página y marca booking.checked_out en Only if you tick it. Nunca se envía a un endpoint que recibe todos los eventos. También salta con los cobros en el punto de venta propio de Bookatu (sale.source bookatu), con el mismo contenido que GET y el cliente solo con su id.
6. La referencia completa, con cada campo y ejemplos, está en la documentación para desarrolladores, en /developers#checkout-handoff, y en markdown en /developers.md.
