HairConnect Manuel Connexion

Buckaroo et le terminal de paiement

Mis à jour le 2026-11-15

Buckaroo (betaalterminal) (terminal de paiement)

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. (Lit chaque nuit les paiements par carte de votre terminal et les versements de Buckaroo, et les place jour par jour à côté des tickets dans le journal de caisse. Lecture seule : aucun montant n'est envoyé au terminal.)

Buckaroo traite les paiements d'un terminal de carte et verse ensuite l'argent sur votre compte bancaire. Si vous avez reçu votre terminal par Optios (Optios PAY), regardez votre extrait de compte : si l'argent des cartes vient de Stichting Derdengelden Buckaroo, c'est votre intégration.

Ce qu'elle fait :

  • Chaque matin à 06:30, HairConnect lit les paiements du terminal des sept derniers jours, et les versements de Buckaroo.
  • Chaque paiement est placé à côté d'un paiement par carte sur un ticket de la même journée de caisse. Par jour, tickets, terminal et versement se retrouvent dans le tableau Kaartbetalingen (paiements par carte) du journal de caisse. Le fonctionnement et la signification des statuts sont décrits dans Journal de caisse et transactions.
  • Les versements de Buckaroo sur votre compte bancaire sont reconnus. Ils disparaissent de Overschrijvingen → Niet gekoppeld (virements → non associé) : ce ne sont pas des clients qui paient un ticket.

Ce qu'elle ne fait pas : aucun montant n'est envoyé au terminal, aucun mail ne part, aucun ticket n'est créé et aucun montant sur un ticket ne change.

Une clé en lecture seule

  1. Connectez-vous à My Buckaroo (my.buckaroo.io).
  2. Créez une nouvelle clé API.
  3. Cochez uniquement les droits de lecture pour les ventes et les versements — dans le portail en néerlandais Verkopen: Lezen et Uitbetaling: Lezen. Il n'en faut pas plus, et une clé qui ne peut rien modifier ne peut rien modifier non plus si elle fuit un jour.
  4. Copiez la clé. Elle commence par apk_.

Les droits que vous pouvez cocher dans My Buckaroo dépendent de votre rôle. Si vous ne voyez pas ces deux droits, demandez-les à la personne qui gère le compte Buckaroo.

Configuration

Instellingen → Koppelingen → Betalen → Buckaroo (betaalterminal) → Instellen (Paramètres → Intégrations → Paiements → Buckaroo (terminal de paiement) → Configurer). Seul le gérant peut ouvrir cet écran.

Champ Obligatoire Explication
API-sleutel (clé API) oui La clé ci-dessus. Elle est conservée chiffrée, pour ce salon uniquement.
Rekening waarvan Buckaroo stort (compte depuis lequel Buckaroo verse) non Après la première nuit, HairConnect propose ici un compte : celui qui verse chaque matin exactement ce que le terminal a vu la veille, avec le nombre de versements qui correspondent au cent près. Cliquez sur Voorstel overnemen (reprendre la proposition) et enregistrez. Si vous le laissez vide, les tickets sont quand même placés à côté du terminal, mais les versements ne sont pas contrôlés.
Betaalmiddelen die over de terminal lopen (moyens de paiement qui passent par le terminal) non Par défaut Bancontact et la carte de crédit. Uniquement ce qui est payé par carte au comptoir : un paiement par code QR ou en ligne ne passe pas par ce terminal.
Geschiedenis ophalen vanaf (niet verplicht) (récupérer l'historique depuis, facultatif) non Une fois : la nuit suivante, HairConnect lit les paiements depuis ce jour, par exemple le début de l'exercice. Ensuite, chaque nuit regarde sept jours en arrière. Vide : seulement les sept derniers jours.
Winkel-id (niet verplicht) (identifiant de magasin, facultatif) non Uniquement si plusieurs commerces dépendent du même compte Buckaroo : HairConnect ne lit alors que les paiements de cet identifiant.
TID van de terminal (niet verplicht) (TID du terminal, facultatif) non Uniquement si un deuxième terminal qui n'appartient pas à ce salon dépend du même compte. Le TID figure sur le ticket du terminal.

Verbinding testen (tester la connexion) lit un paiement des trente derniers jours et demande les versements. Si cela fonctionne, vous lisez par exemple De sleutel werkt. Laatste betaling: € 64,00 op 04/11/2026 om 14:58. De uitbetalingen lezen lukt ook. (La clé fonctionne. Dernier paiement : 64,00 € le 04/11/2026 à 14:58. La lecture des versements fonctionne aussi.) Si Buckaroo refuse la clé, le test dit pourquoi : une clé qui n'a pas été collée entièrement, ou une clé sans les deux droits. Le test, lui aussi, ne fait que lire.

La première fois, et après une interruption

La ronde de nuit regarde sept jours en arrière. Si vous voulez le contrôle des cartes plus loin dans le passé, par exemple depuis le début de l'exercice, remplissez Geschiedenis ophalen vanaf. La nuit suivante, HairConnect récupère tout depuis ce jour, par tranches d'un mois ; les nuits suivantes, de nouveau sept jours.

Si aucune ronde n'a tourné pendant un temps, parce que le module était désactivé ou que le serveur était à l'arrêt, la ronde suivante récupère aussi ces jours-là d'elle-même, à partir de l'endroit où la précédente s'est arrêtée.

Un jour antérieur à la première récupération ne figure pas dans le tableau Kaartbetalingen. Sinon, chaque ticket par carte de ce jour ressemblerait à une différence, alors que le terminal n'était simplement pas encore lu. Aujourd'hui n'y figure pas encore non plus : une journée encore en cours montrerait un terminal qui a vu trop peu.

Tant qu'elle est désactivée

Si le module est désactivé, ou activé sans clé, HairConnect ne demande rien à Buckaroo. Le tableau Kaartbetalingen disparaît du journal de caisse, la tuile de l'Overzicht (aperçu) aussi, et la Kaartcontrole (contrôle des cartes) indique qu'elle est désactivée. Ce qui a déjà été récupéré reste conservé.

Ce qu'une personne a confirmé dans la Kaartcontrole reste tel que cela a été confirmé.