Buckaroo en de betaalterminal
Bijgewerkt op 2026-11-15
Buckaroo (betaalterminal)
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.
Buckaroo verwerkt de betalingen van een kaartterminal en stort het geld daarna op je bankrekening. Kreeg je je terminal via Optios (Optios PAY), kijk dan op je rekeninguittreksel: komt het kaartgeld van Stichting Derdengelden Buckaroo, dan is dit je koppeling.
Wat ze doet:
- Elke ochtend om 06:30 leest HairConnect de betalingen van de terminal van de voorbije zeven dagen, en de uitbetalingen van Buckaroo.
- Elke betaling wordt naast een kaartbetaling op een bon van dezelfde kassadag gelegd. Per dag komen bonnen, terminal en storting samen in de tabel Kaartbetalingen van het kassaboek. Hoe dat werkt en wat de statussen betekenen, staat in Kassaboek en transacties.
- De stortingen van Buckaroo op je bankrekening worden herkend. Ze verdwijnen uit Overschrijvingen → Niet gekoppeld: het zijn geen klanten die een bon betalen.
Wat ze niet doet: er vertrekt geen bedrag naar de terminal, er vertrekt geen mail, er wordt geen bon gemaakt en er verandert geen bedrag op een bon.
Een sleutel die alleen mag lezen
- Meld je aan in My Buckaroo (my.buckaroo.io).
- Maak een nieuwe API-sleutel.
- Vink alleen de rechten Verkopen: Lezen en Uitbetaling: Lezen aan. Meer is niet nodig, en een sleutel die niets kan veranderen, kan ook niets veranderen als hij ooit uitlekt.
- Kopieer de sleutel. Hij begint met
apk_.
Welke rechten je in My Buckaroo kan aanvinken, hangt af van je rol daar. Zie je de twee rechten niet, vraag ze dan aan wie het Buckaroo-account beheert.
Instellen
Instellingen → Koppelingen → Betalen → Buckaroo (betaalterminal) → Instellen. Alleen de zaakvoerder komt op dit scherm.
| Veld | Verplicht | Toelichting |
|---|---|---|
| API-sleutel | ja | De sleutel van hierboven. Hij wordt versleuteld bewaard, voor dit salon alleen. |
| Rekening waarvan Buckaroo stort | nee | Na de eerste nacht stelt HairConnect hier een rekening voor: de rekening die elke ochtend precies stort wat de terminal de dag ervoor zag, met hoeveel stortingen er tot op de cent kloppen. Klik Voorstel overnemen en bewaar. Laat je het leeg, dan worden de bonnen wel naast de terminal gelegd, maar de stortingen niet nagekeken. |
| Betaalmiddelen die over de terminal lopen | nee | Standaard Bancontact en de kredietkaart. Alleen wat aan de toog met de kaart betaald wordt: een betaling met een QR-code of online loopt niet over deze terminal. |
| Geschiedenis ophalen vanaf (niet verplicht) | nee | Eén keer: de eerstvolgende nacht leest HairConnect de betalingen vanaf deze dag, bijvoorbeeld het begin van het boekjaar. Daarna kijkt elke nacht zeven dagen terug. Leeg: alleen de voorbije zeven dagen. |
| Winkel-id (niet verplicht) | nee | Alleen als er onder hetzelfde Buckaroo-account meer dan één zaak hangt: dan leest HairConnect enkel de betalingen van deze winkel-id. |
| TID van de terminal (niet verplicht) | nee | Alleen als er een tweede terminal onder hetzelfde account hangt die niet bij dit salon hoort. De TID staat op het kasticket van de terminal. |
Verbinding testen leest één betaling van de voorbije dertig dagen en vraagt de uitbetalingen op. Lukt het, dan lees je bijvoorbeeld De sleutel werkt. Laatste betaling: € 64,00 op 04/11/2026 om 14:58. De uitbetalingen lezen lukt ook. Weigert Buckaroo de sleutel, dan zegt de proef waarom: een sleutel die niet volledig geplakt is, of een sleutel zonder de twee rechten. Ook de proef leest alleen.
De eerste keer, en na een gat
De nachtelijke ronde kijkt zeven dagen terug. Wil je de kaartcontrole van verder terug, bijvoorbeeld vanaf het begin van het boekjaar, vul dan Geschiedenis ophalen vanaf in. De eerstvolgende nacht haalt HairConnect alles vanaf die dag op, in stukken van een maand; de nachten daarna weer zeven dagen.
Liep er een tijd geen ronde, omdat de module uit stond of de server plat lag, dan haalt de volgende ronde vanzelf ook die dagen op, vanaf waar de vorige stopte.
Een dag van vóór de eerste ophaling staat niet in de tabel Kaartbetalingen. Anders zou elke kaartbon van die dag een verschil lijken, terwijl de terminal toen gewoon nog niet gelezen werd. Ook vandaag staat er nog niet in: een dag die nog bezig is, zou een terminal tonen die te weinig zag.
Zolang ze uit staat
Staat de module uit, of staat ze aan zonder sleutel, dan vraagt HairConnect niets bij Buckaroo. De tabel Kaartbetalingen verdwijnt uit het kassaboek, de tegel op het Overzicht ook, en de Kaartcontrole zegt dat ze uit staat. Wat al opgehaald was, blijft bewaard.
Wat een mens in de Kaartcontrole bevestigde, blijft staan zoals het bevestigd werd.