RetailVista kan betalingsverzoeken online laten afhandelen door een betaaldienst: Buckaroo, Pay.nl, Stripe of Tikkie. Een betalingsverzoek is bijvoorbeeld handig als op een verkooporder nog een aanbetaling nodig is. Betalingsverzoeken worden ook gebruikt bij de uitgifte van reserveringen (rembours) en als betaalwijze in RetailVista POS: werkt een betaalterminal niet en kan de klant niet contant betalen, dan toont de kassa een QR-code van de betaaldienst.
Dit artikel beschrijft de eenmalige inrichting. Hoe een aanbetalingsverzoek daarna via de betaaldienst tot een aanbetaling op de verkooporder leidt, staat in Betalingsverzoeken via een betaaldienst: van aanbetalingsverzoek tot aanbetaling.
Overzicht
| Onderdeel | Waarvoor |
|---|---|
| Betaaldienst | Gegevens om met de betaaldienst te communiceren. |
| Type aanbetaling | Het type waarmee een betaald verzoek als aanbetaling wordt geboekt. |
| Verkooporder scenario | Koppelt dat type aanbetaling aan de verkooporders. |
| E-mailsjabloon | De e-mail met de betaallink aan de klant. |
| Taakplanner | Maakt en verstuurt de betalingsverzoeken. |
Betaaldienst aanmaken
Via de pagina 'Betaaldiensten' wordt een nieuwe betaaldienst aangemaakt. Het veld 'Betaalwijze' bepaalt bij welke betaaldienst de betalingsverzoeken worden aangeboden. Welke andere velden nodig zijn, verschilt per betaaldienst; zie hieronder. Betalingsverzoeken werken alleen in euro's.
'Auto verwerken terugbetalingen' gaat over terugbetalingen naar de klant en heeft geen invloed op betalingsverzoeken.
Instellingen per betaaldienst
De gegevens komen uit de beheeromgeving van de betaaldienst. Velden die niet genoemd worden, blijven leeg.
Buckaroo
| Veld | Waarde |
|---|---|
| Betaalwijze | Buckaroo |
| API sleutel | De Secret key uit Buckaroo Plaza, op de pagina met API-sleutels, tabblad 'Secret key'. |
| Geavanceerde instellingen | WebsiteKey= gevolgd door de websitesleutel uit Buckaroo Plaza. |
Let op: De websitesleutel en de secret key zijn twee verschillende sleutels. Staat bij 'API sleutel' de websitesleutel, dan weigert Buckaroo elke aanroep en krijgen betalingsverzoeken de status 'Mislukt'.
De klant kiest bij Buckaroo de betaalmethode op de betaalpagina van Buckaroo; de betaallink is 7 dagen geldig.
Pay.nl
| Veld | Waarde |
|---|---|
| Betaalwijze | PayNL |
| Gebruikersnaam | De tokencode (begint met AT-). |
| API sleutel | De API-token die bij die tokencode hoort. |
| Geavanceerde instellingen | ServiceId= gevolgd door de service-id van de verkooplocatie (begint met SL-). |
Stripe
| Veld | Waarde |
|---|---|
| Betaalwijze | Stripe |
| API sleutel | De geheime sleutel (secret key) uit het Stripe-dashboard. |
| API Url | https://api.stripe.com (verplicht; met een leeg veld mislukt elke aanroep). |
Bij Stripe wordt de status alleen bijgewerkt als de klant na het betalen terugkomt op de bevestigingspagina van RetailVista.
Tikkie
| Veld | Waarde |
|---|---|
| Betaalwijze | Tikkie |
| API Url | https://api.abnamro.com/v2/tikkie |
| API sleutel | De API-key van de app in het ABN AMRO Developer Portal. |
| Geavanceerde instellingen | AppToken= gevolgd door het app-token uit Tikkie Zakelijk. |
De betaallink van Tikkie is 7 dagen geldig.
Type aanbetaling
Een betaald betalingsverzoek wordt als aanbetaling op de verkooporder geboekt. Daarvoor is een type aanbetaling nodig met als 'Aanbetaling type' 'Betaaldienst'; zie Aanbetaling types. Bij 'Artikelnummer' kan een artikel worden opgegeven; zonder artikel geldt de instelling 'Aanbetaling artikel nr'. Dat artikel moet een btw-percentage van 0% hebben.
Verkooporder scenario
Kies in elk verkooporder scenario waarmee betalingsverzoeken worden gebruikt, op het tabblad 'Verkooporders', bij 'Aanbetalingstype voor betaalde aanbetalingsverzoeken' het type aanbetaling uit de vorige stap.
Let op: Zonder deze instelling wordt bij een betaald betalingsverzoek geen aanbetaling op de verkooporder geboekt. Een type 'Contant via kassa' werkt hier niet: de boeking mislukt en de klant ziet na het betalen een foutmelding.
E-mailsjabloon
De taakplanner stuurt de klant een e-mail met de betaallink. De inhoud komt uit een e-mailsjabloon. Maak voor elke taal waarin klanten e-mail ontvangen een e-mailsjabloon aan met als basissjabloon 'PaymentRequest'. Zonder sjabloon in de taal van de relatie wordt er geen e-mail verstuurd.
In onderwerp en tekst zijn deze plaatshouders te gebruiken:
| Plaatshouder | Wordt vervangen door |
|---|---|
| [CustomerName] | De naam van de relatie. |
| [PaymentUrl] | De betaallink. |
| [Value] | Het te betalen bedrag. |
| [SaleOrderNumber] | Het verkoopordernummer. |
| [SaleOrderReference] | De referentie van de verkooporder. |
| [StoreName] | De naam van de vestiging. |
Taakplanner
Maak een taakplanning aan van het type 'Verstuur betaalverzoeken', als die er nog niet is. Deze taak maakt van aanbetalingsverzoeken betalingsverzoeken, meldt nieuwe betalingsverzoeken aan bij de betaaldienst, zet de e-mails klaar en controleert de status van verstuurde verzoeken. Het kortste interval is 15 minuten.
Testen
Test bij voorkeur de hele keten met een testverkooporder:
- Maak een verkooporder voor een relatie met een eigen e-mailadres.
- Voeg een aanbetalingsverzoek toe met een klein bedrag en kies de betaaldienst.
- Maak de verkooporder 'Definitief'.
- Wacht op de taak 'Verstuur betaalverzoeken'. Het betalingsverzoek staat dan op 'Verstuurd', met een 'Referentie' en een 'Betaling URL', en de e-mail staat bij de uitgaande e-mailberichten.
- Betaal via de link. Na het betalen staat het betalingsverzoek op 'Betaald' en staat de aanbetaling op de verkooporder.
Alleen de verbinding met de betaaldienst testen kan ook met een los betalingsverzoek. Kies daarbij een relatie met een e-mailadres en laat 'Referentie' leeg. Zo'n los betalingsverzoek leidt niet tot een aanbetaling.
