Buckaroo y el terminal de pago
Actualizado el 2026-11-15
Buckaroo (betaalterminal) (terminal de pago)
Leest elke nacht de kaartbetalingen van uw betaalterminal en de stortingen van Buckaroo, en legt ze per dag naast de bonnen in het kassaboek. Alleen lezen: er vertrekt geen bedrag naar de terminal. (Lee cada noche los pagos con tarjeta de tu terminal y los abonos de Buckaroo, y los coloca día a día junto a los tickets en el libro de caja. Solo lectura: no se envía ningún importe al terminal.)
Buckaroo procesa los pagos de un terminal de tarjetas y después abona el dinero en tu cuenta bancaria. Si recibiste tu terminal a través de Optios (Optios PAY), mira tu extracto: si el dinero de las tarjetas viene de Stichting Derdengelden Buckaroo, esta es tu integración.
Lo que hace:
- Cada mañana a las 06:30, HairConnect lee los pagos del terminal de los últimos siete días, y los abonos de Buckaroo.
- Cada pago se coloca junto a un pago con tarjeta en un ticket del mismo día de caja. Por día, tickets, terminal y abono se juntan en la tabla Kaartbetalingen (pagos con tarjeta) del libro de caja. Cómo funciona y qué significan los estados está en Libro de caja y transacciones.
- Los abonos de Buckaroo en tu cuenta bancaria se reconocen. Desaparecen de Overschrijvingen → Niet gekoppeld (transferencias → sin vincular): no son clientes que pagan un ticket.
Lo que no hace: no se envía ningún importe al terminal, no sale ningún correo, no se crea ningún ticket y no cambia ningún importe de un ticket.
Una clave que solo puede leer
- Inicia sesión en My Buckaroo (my.buckaroo.io).
- Crea una nueva clave API.
- Marca solo los derechos de lectura de ventas y abonos — en el portal en neerlandés Verkopen: Lezen y Uitbetaling: Lezen. No hace falta más, y una clave que no puede cambiar nada tampoco puede cambiar nada si algún día se filtra.
- Copia la clave. Empieza por
apk_.
Los derechos que puedes marcar en My Buckaroo dependen de tu rol allí. Si no ves los dos derechos, pídeselos a quien gestiona la cuenta de Buckaroo.
Configurar
Instellingen → Koppelingen → Betalen → Buckaroo (betaalterminal) → Instellen (Ajustes → Integraciones → Pagos → Buckaroo (terminal de pago) → Configurar). Solo el gerente puede abrir esta pantalla.
| Campo | Obligatorio | Explicación |
|---|---|---|
| API-sleutel (clave API) | sí | La clave de arriba. Se guarda cifrada, solo para este salón. |
| Rekening waarvan Buckaroo stort (cuenta desde la que abona Buckaroo) | no | Tras la primera noche, HairConnect propone aquí una cuenta: la que cada mañana abona exactamente lo que el terminal vio el día anterior, con cuántos abonos cuadran al céntimo. Haz clic en Voorstel overnemen (aceptar la propuesta) y guarda. Si lo dejas vacío, los tickets se colocan igualmente junto al terminal, pero los abonos no se comprueban. |
| Betaalmiddelen die over de terminal lopen (medios de pago que pasan por el terminal) | no | Por defecto Bancontact y la tarjeta de crédito. Solo lo que se paga con tarjeta en el mostrador: un pago con código QR o en línea no pasa por este terminal. |
| Geschiedenis ophalen vanaf (niet verplicht) (recuperar el historial desde, opcional) | no | Una vez: la noche siguiente HairConnect lee los pagos desde este día, por ejemplo el inicio del ejercicio. Después, cada noche mira siete días atrás. Vacío: solo los últimos siete días. |
| Winkel-id (niet verplicht) (id de tienda, opcional) | no | Solo si de la misma cuenta de Buckaroo dependen varios negocios: entonces HairConnect solo lee los pagos de este id de tienda. |
| TID van de terminal (niet verplicht) (TID del terminal, opcional) | no | Solo si de la misma cuenta depende un segundo terminal que no pertenece a este salón. El TID figura en el ticket del terminal. |
Verbinding testen (probar la conexión) lee un pago de los últimos treinta días y pide los abonos. Si funciona, lees por ejemplo De sleutel werkt. Laatste betaling: € 64,00 op 04/11/2026 om 14:58. De uitbetalingen lezen lukt ook. (La clave funciona. Último pago: 64,00 € el 04/11/2026 a las 14:58. La lectura de los abonos también funciona.) Si Buckaroo rechaza la clave, la prueba dice por qué: una clave que no se pegó entera, o una clave sin los dos derechos. La prueba también solo lee.
La primera vez, y después de un hueco
La ronda nocturna mira siete días atrás. Si quieres el control de tarjetas desde más atrás, por ejemplo desde el inicio del ejercicio, rellena Geschiedenis ophalen vanaf. La noche siguiente HairConnect recupera todo desde ese día, por tramos de un mes; las noches siguientes, otra vez siete días.
Si durante un tiempo no se ejecutó ninguna ronda, porque el módulo estaba desactivado o el servidor estaba caído, la ronda siguiente recupera también esos días por sí sola, desde donde se detuvo la anterior.
Un día anterior a la primera recuperación no aparece en la tabla Kaartbetalingen. Si no, cada ticket con tarjeta de ese día parecería una diferencia, cuando el terminal simplemente aún no se había leído. Hoy tampoco aparece todavía: un día que sigue en curso mostraría un terminal que vio demasiado poco.
Mientras está desactivada
Si el módulo está desactivado, o activado sin clave, HairConnect no pide nada a Buckaroo. La tabla Kaartbetalingen desaparece del libro de caja, también la casilla del Overzicht (resumen), y el Kaartcontrole (control de tarjetas) indica que está desactivado. Lo que ya se había recuperado se conserva.
Lo que alguien confirmó en el Kaartcontrole se queda tal como se confirmó.