Een API-sleutel maken bij Stripe of Mollie

Testsleutel of live-sleutel

Elk account heeft twee soorten sleutels. Met een testsleutel wordt er niets echt betaald: je krijgt een testscherm van de provider in plaats van een echte betaling. Met de live-sleutel betalen gasten met echt geld, dat op de rekening van de vereniging komt.

In Vulsmul is een testsleutel genoeg om alles te oefenen: in de oefenmodus gebruikt Vulsmul de testsleutel. Om live te gaan, heb je de live-sleutel nodig. Je kan met de testsleutel beginnen en de live-sleutel later toevoegen. Een werkende live-sleutel krijg je pas als het account bij de provider geactiveerd is, dus vraag dat ruim op voorhand aan.

Bij Stripe

1. Meld je aan op dashboard.stripe.com met het account van de vereniging.
2. Kies of je de test- of de live-sleutel wil. Bovenaan het dashboard staat een schakelaar voor de testomgeving (Test mode of Sandbox, afhankelijk van de versie). Staat die aan, dan zie je de testsleutels.
3. Open in het menu Developers / Ontwikkelaars de pagina API keys / API-sleutels.
4. Kopieer de geheime sleutel (Secret key). Die begint met sk_test_ of sk_live_. De publieke sleutel (pk_…) heb je niet nodig.

Aangeraden: een beperkte sleutel

Een geheime sleutel mag alles op jullie Stripe-account. Veiliger is een beperkte sleutel (Restricted key), die enkel mag wat Vulsmul echt doet. Maak die op dezelfde pagina aan, geef hem een herkenbare naam zoals “Vulsmul”, en zet exact deze rechten:

• Checkout Sessions: Write — om de betaalpagina voor een bestelling aan te maken en daarna na te kijken of ze betaald is.
• Balance: Read — daarmee controleert Vulsmul bij het koppelen dat de sleutel werkt.

Alle andere rechten laat je op None. Een beperkte sleutel begint met rk_test_ of rk_live_. Maak hem apart aan in de testomgeving en in live.

Testen met Stripe

In de oefenmodus betaal je op de testpagina van Stripe met kaartnummer 4242 4242 4242 4242, een vervaldatum in de toekomst en eender welke CVC-code.

Bij Mollie

1. Meld je aan op my.mollie.com met het account van de vereniging.
2. Open in het menu Developers / Ontwikkelaars de pagina API keys / API-sleutels. Heeft jullie account meer dan één websiteprofiel, kies dan eerst het juiste profiel: de sleutels horen bij een profiel.
3. Kopieer de testsleutel (begint met test_) en, als het account geactiveerd is, de live-sleutel (begint met live_).

De live-sleutel werkt pas als Mollie jullie profiel geactiveerd heeft. Zet daar ook de betaalmethodes aan die gasten mogen gebruiken, zeker Bancontact.

Testen met Mollie

Met de testsleutel kom je op een testscherm van Mollie, waar je zelf kiest hoe de betaling afloopt: betaald, mislukt, geannuleerd of verlopen. Zo kan je in de oefenmodus ook nakijken wat een gast ziet als het misloopt.

De sleutel in Vulsmul zetten

1. Ga in Vulsmul naar Online betalen in het menu van je vereniging. Enkel eigenaars en beheerders van de vereniging kunnen daar sleutels koppelen.
2. Kies bij Account koppelen Stripe of Mollie en geef het account een naam, bijvoorbeeld “Vereniging” of “Oudercomité”.
3. Plak de sleutels in de velden Testsleutel en Live-sleutel. Eén van de twee is genoeg om te beginnen. Klik op Controleren en koppelen: Vulsmul probeert de sleutel meteen bij de provider.
4. Ontbreekt er later nog een sleutel, voeg hem dan toe via Beheren bij het account.

Vulsmul bewaart de sleutel versleuteld en toont daarna enkel de laatste vier tekens. Je kan hem dus niet meer uit Vulsmul aflezen, ook niet als beheerder.

Veilig omgaan met de sleutel

Een geheime sleutel is zoals de code van de kluis. Stuur hem nooit door via mail, WhatsApp of Messenger, en zet hem niet in een gedeeld document. Wie de sleutel in Vulsmul zet, kopieert hem best rechtstreeks uit het dashboard van de provider en plakt hem meteen.

Is een sleutel toch uitgelekt? Vervang hem meteen, ook midden in een evenement:

1. Maak in het dashboard van de provider een nieuwe sleutel aan. Bij Stripe kan dat met Roll key bij de sleutel, of door een nieuwe beperkte sleutel te maken. Bij Mollie genereer je een nieuwe sleutel op de pagina met API-sleutels; de oude werkt dan meteen niet meer.
2. Zet de nieuwe sleutel in Vulsmul via Beheren bij het account. Nieuwe betalingen gebruiken vanaf dan de nieuwe sleutel.
3. Heb je bij Stripe de oude sleutel nog laten bestaan, trek hem dan in zodra de nieuwe in Vulsmul staat.

Kijk daarna in het dashboard van de provider na of er betalingen of terugbetalingen zijn die niemand van jullie herkent.

Veelgestelde vragen

Verder lezen

• Zelf bestellen met QR — hoe het geld loopt, wat het kost, en wanneer je het beter niet doet.
• Eetfestijn organiseren — het volledige overzicht, van zaal tot afrekening.