Viva.com en de betaalterminal
Bijgewerkt op 2026-08-28
Viva.com
Stuur het bedrag van de kassa naar de betaalterminal op de balie, zonder het over te typen.
Zonder koppeling typt de kapper het bedrag over op de kaartlezer. Met koppeling duwt de kassa het erheen, en ziet ze zelf of er betaald is — geen typfouten meer, en de bon sluit vanzelf af.
Bij Viva loopt dat over hun Cloud Terminal API: de kassa stuurt het bedrag naar Viva, Viva duwt het naar je toestel, en de kassa vraagt daarna elke seconde wat ervan geworden is. Het toestel hoeft dus niet op hetzelfde wifinetwerk te staan als de iPad.
Nog niet beschikbaar. Je kan de sleutels al invullen en proeven, maar de schakelaar blijft weg:
De koppeling is gebouwd maar nog niet tegen een echt toestel gedraaid, en het is bij Viva nog niet bevestigd of Bancontact op de terminal aangenomen wordt. Vul de sleutels gerust al in en druk op Verbinding testen — aanzetten kan zodra een proefbetaling op een echte terminal gelukt is.
Lees dit vóór je iets bestelt: Bancontact is niet bevestigd
In een Belgisch kapsalon betaalt de meerderheid met Bancontact. Wij weten vandaag niet zeker of een Viva-terminal die kaart aanneemt, en wij gaan dat niet mooier voorstellen dan het is:
- Hun Belgische tarievenpagina noemt Bancontact uitdrukkelijk als kaartbetaling ter plaatse: Card Present — Bancontact consumer card — € 0,14. Dat is het sterkste teken dat het kan.
- Maar in de lijst van betaalmiddelen op het toestel in hun ontwikkelaarsdocumentatie staat Bancontact niet. Daar duikt het alleen op bij de online betaalmiddelen ("Bancontact QR").
Een tarief is nog geen werkende terminal. Vraag het uitdrukkelijk aan Viva vóór je een toestel bestelt of een contract tekent, en vraag er meteen bij of het als Bancontact of als co-badged Maestro afgerekend wordt — dat scheelt in het tarief en in wat je klant op het scherm ziet.
En let op de looptijd van het toestel
Een kaartlezer bij Viva kan je op twee manieren nemen, en het verschil is groter dan de prijs:
| Kopen | je betaalt het toestel één keer en zit nergens aan vast; de goedkoopste lezer in hun winkel staat op € 49 |
| Per maand | goedkoper om te beginnen — vanaf zowat € 8 per maand — maar met een looptijd van 24 maanden en een verbrekingsvergoeding als je er vroeger uit wil |
Die looptijd staat in de kleine lettertjes bij het maandtarief en niet bij de prijs; laat hem bevestigen vóór je tekent. En wie twijfelt of Bancontact werkt, hoort niet aan een contract van twee jaar te beginnen: koop het toestel, of wacht tot je een proefbetaling hebt zien lukken.
Wat je nodig hebt
| Een Viva.com-account | op naam van je eigen zaak, met je eigen uitbetaling |
| POS API-sleutels | een client-id en een client secret uit het Viva-portaal |
| Een terminal die aangemeld is | met de Viva.com Terminal-app, en zichtbaar als Live |
| De terminal-id van elk toestel | in de app onder Meer → Over → Source Terminal ID |
Instellen
Instellingen → Koppelingen → Betalen → Viva.com → Instellen.
| Veld | Verplicht | Toelichting |
|---|---|---|
| Client-id | ja | Viva-portaal → Instellingen → API-toegang → POS APIs credentials. Een lange code die op .apps.vivapayments.com eindigt. |
| Client secret | ja | Uit hetzelfde scherm. Viva toont hem één keer; bewaar hem meteen. |
| Omgeving | ja | Begin in de proefomgeving. Zet dit pas op productie als je een proefbetaling hebt zien lukken. |
De sleutels horen bij het salon; welke terminal aan welke kassa hangt, wordt per kassa vastgelegd. Twee balies met twee toestellen zijn dus twee verschillende terminal-id's onder één stel sleutels.
De proef
Klik Verbinding testen. De proef vraagt welke toestellen er live staan: er wordt niets aangemaakt en er beweegt geen geld. Mogelijke antwoorden:
- 2 terminals live gevonden (eerste: 16000010).
- De sleutels kloppen, maar er staat geen enkele terminal live op dit Viva-account. Zet het toestel aan en meld het aan met de Viva.com Terminal-app.
- Viva: de client-id of het geheim wordt geweigerd.
- Viva is niet bereikbaar. Netwerkprobleem?
Nul terminals is hier wel een mislukte proef, anders dan bij Stripe: deze koppeling bestaat alleen om met een toestel af te rekenen.
In de kassa
Je slaat de bon aan, de kassa zet het bedrag op de terminal en wacht. Wat de kassa toont:
| Wat je ziet | Wat het betekent |
|---|---|
| Bezig | Het bedrag staat op de terminal. De klant heeft zijn kaart nog niet aangeboden. |
| Betaald | De betaling is gelukt en staat op de bon. |
| Geweigerd | De kaart is geweigerd — te weinig saldo, verkeerde pincode. Probeer een andere kaart. |
| Geannuleerd | Er is afgebroken, op het toestel of vanuit de kassa. |
| Geen antwoord | Niemand weet of er geld bewogen is. Kijk op het toestel of in het Viva-portaal vóór je opnieuw aanslaat. |
Die laatste is met opzet géén "mislukt". Een betaling waarvan we het antwoord niet kregen, mag de kassa niet stilzwijgend wegzetten: dan slaat de kapper ze een tweede keer aan terwijl de klant al betaald heeft.
Fooien staan uit. De kassa stuurt altijd exact het bedrag van de bon, en vraagt op het toestel niet om een fooi: een bedrag dat op de terminal groeit, klopt daarna niet meer met je dagontvangsten.
Afbreken
Duw je in de kassa op annuleren, dan vraagt HairConnect aan Viva om de opdracht in te trekken. Dat lukt alleen zolang de kaart nog niet gelezen is. Is de klant al bezig, dan lees je De betaling loopt al op de terminal — afbreken kan dan alleen nog op het toestel zelf, en de kassa wacht af hoe het afloopt.
Terugbetalen
Een terugbetaling gaat óók naar de terminal: er moet iemand bij staan om ze af te ronden, net als bij een gewone betaling. De kassa zet de terugbetaling daarom op bezig en niet meteen op klaar — pas als het toestel bevestigt, is het geld onderweg.