Voor je begint Link naar dit onderdeel
Betalingen lopen via je eigen Stripe-account, zodat Stripe het geld uitbetaalt op je eigen bankrekening. Heb je nog geen account, maak er dan een aan op stripe.com en doorloop de controles die Stripe vraagt. Je kan hetzelfde account gebruiken als voor je webshop of donaties.
TinyForms vraagt een beperkte sleutel: een sleutel die alleen kan wat TinyForms nodig heeft, en verder niets in je account. Een geheime sleutel werkt ook, maar een beperkte sleutel is de veiligere keuze.
Een beperkte sleutel aanmaken Link naar dit onderdeel
Log in bij Stripe
Ga naar dashboard.stripe.com en meld je aan met het account dat de betalingen moet ontvangen.
Open Developers en dan API keys
Zoek in het dashboard naar API keys, of open Developers en daarna API keys, en kies Create restricted key om een beperkte sleutel aan te maken.
Geef hem de juiste rechten
Noem hem TinyForms en zet deze vier op Write: Checkout Sessions, Payment Intents, Refunds en Webhook Endpoints. Laat al de rest op None.
Kopieer de sleutel
Maak de sleutel aan en kopieer hem. Een live beperkte sleutel begint met "rk_live_". Stripe toont hem maar één keer, dus plak hem meteen.
Plak hem in TinyForms
Ga naar je werkruimte-instellingen, open de sectie Betalingen, kies Stripe, plak de sleutel en sla op.
Bij het opslaan controleert TinyForms de sleutel bij Stripe en maakt het een webhook aan in je Stripe-account, die TinyForms laat weten wanneer een betaling gelukt, mislukt of verlopen is. Je vindt hem onder Developers, Webhooks, met TinyForms in de beschrijving. Laat hem staan: zonder webhook kunnen betalingen niet bevestigd worden.
Sleutel geweigerd?
Ontbreekt er een recht, dan zeggen de instellingen dat en wordt er niets opgeslagen. Pas de sleutel aan in Stripe, geef hem de vier rechten hierboven en plak hem opnieuw. Een publiceerbare sleutel (die begint met pk_) werkt niet: daarmee kan je geen betalingen aanmaken.
Test eerst
In testmodus geeft Stripe je sleutels die beginnen met "rk_test_" of "sk_test_". Daarmee doorloop je de volledige flow met testkaarten en zonder echt geld, en de instellingen tonen het label Testmodus. Zet de live sleutel in de plaats voor je het formulier deelt.
Houd de sleutel veilig Link naar dit onderdeel
Met je sleutel kunnen betalingen en terugbetalingen op je Stripe-account worden aangemaakt, dus behandel hem als een wachtwoord. TinyForms bewaart hem versleuteld, samen met het ondertekeningsgeheim van de webhook, en toont geen van beide nog na het opslaan.
Als de sleutel toch lekt, vernieuw of verwijder hem dan in het Stripe-dashboard, maak een nieuwe aan en plak die in je werkruimte-instellingen. TinyForms vervangt dan ook zijn webhook.