Stripe configureren

Stripe ondersteunt meer dan honderd valuta en heel veel verschillende betaalmethodes. Voor populaire betaalmethodes, zoals creditcard en iDEAL | Wero-betalingen, is er een directe integratie ingebouwd op het betaalscherm van de agenda. Als u een andere betaalmethode wilt gebruiken kan het systeem de gebruikers doorsturen naar de betaalpagina van Stripe, die dan de betaling aan SuperSaaS doorgeeft.

Om Stripe te gebruiken met uw SuperSaaS account navigeert u naar de “API keys” pagina in uw Stripe account om de benodigde API-codes te verkrijgen:

Creëer een nieuwe “Restricted key”. Selecteer de optie “Building your own integration”. In plaats van een “Restricted” Stripe key kunt u ook een “Secret” key invullen. Deze optie is iets minder veilig dan het gebruik van een “Restricted” key, omdat een “Secret” key volledige toegang geeft tot uw Stripe account.
Geeft de key een naam op het volgende scherm en geef het de “write permission” bevoegdheid voor de “PaymentIntents” en “Checkout Sessions” resource. Selecteer de knop “Create key”
Kopieer de “Publishable key” en de net gecreëerde “Restricted key”.
U kunt ook nog additionele test API-sleutels aanmaken om de integratie te kunnen etsten zonder dat er een betaling plaatsvindt. Dit doet u door “Test mode” aan te zetten en de bovenstaande stappen te herhalen om een test “Restricted key” en een test “Publishable key” te verkrijgen. De “Test mode” setting is te vinden door op de accountnaam linksboven op uw Stripe dashboard te klikken, onder het menu “Switch to sandbox”
Voeg deze vier keys toe aan uw SuperSaaS account bij de Betaalinstellingen onder het kopje Stripe. Stripe gebruikt de valuta zoals die geconfigureerd is bovenaan dit scherm.

Een webhook instellen bij Stripe

Als de gebruiker zijn browser direct na de betaling afsluit dan is er een kans dat er niet aan onze server wordt doorgegeven of de betaling gelukt is. De kans hierop is vooral aanwezig bij betaalmethodes zoals bijvoorbeeld iDEAL | Wero waarbij de gebruiker is doorgestuurd naar de website van zijn bank. Door een webhook in te stellen wordt gezorgd dat ons systeem altijd doorkrijgt of de betaling gelukt is.

Ga naar de “Webhooks” pagina en klik op de knop ‘Eindpunt toevoegen’
Ander het kopje ‘Events’ (“Gebeurtenissen” in het Nederlands) selecteert u de volgende drie: Payment Intent → payment_intent.canceled, payment_intent.payment_failed, payment_intent.succeeded
Voeg optioneel de Charge → charge.refunded gebeurtenis toe zodat het systeem automatisch afspraken kan annuleren wanneer u de betaling via Stripe terugbetaalt
Op het volgende scherm kiest u “Webhook endpoint”
Bij ‘Eindpunt-URL’ vult u het volgende in:
https://www.supersaas.com/payment/stripe_webhook
Het is mogelijk om bij “live modus” en bij “test modus” een webhook aan te maken, het is alleen nodig bij de “live modus”

U kunt Stripe uitproberen door de ‘Test modus’ in de SuperSaaS Betaalinstellingen aan te zetten. Let wel dat zolang deze optie aan staat, iedereen afspraken kan maken zonder een betaling te doen. Nadat u een test betaling heeft afgerond met Stripe, kunt u de betaling terugvinden in uw Stripe dashboard onder ‘Payments’. Als dit slaagt, kunt u de ‘Test modus’ in uw SuperSaaS account weer uit te zetten.

Creditcard, iDEAL | Wero en andere betaalmethodes

Standaard wordt alleen de optie om creditcard betalingen te doen aangezet. U kunt de optie om andere betaalmethodes waaronder iDEAL | Wero aan zetten met de bijbehorende vinkjes. Let op dat de gewenste betaalmethodes ook in uw Stripe dashboard aan moeten staan. Als de betaalmethode die u wilt gebruiken er niet tussen staat, kunt u de optie Gebruik betaalpagina van Stripe aanvinken. De gebruiker wordt dan doorgestuurd naar een betaalpagina van Stripe waarop alle betaalmethodes uit uw Stripe account zichtbaar zijn. Sommige betaalmethodes, zoals Apple Pay, werken alleen met deze optie.

Belasting op betalingen en facturering

Als u belastingen heeft ingesteld, wordt deze informatie als metadata naar Stripe verzonden. Op de factuur wordt de belastinginformatie ook weergegeven.

Op Stripe’s support pagina vindt u meer informatie over Stripe.