Stripe verwerkt kaartbetalingen voor online bestellingen rechtstreeks op één Stripe-account: het account waar de sleutels van de integratie bij horen, meestal dat van het restaurant zelf. Stripe betaalt dat account uit op de bankrekening. OrderTiger houdt binnen Stripe geen kosten in; eventuele kosten van OrderTiger worden apart op de facturen van het restaurant in rekening gebracht.
Wil je binnen Stripe een deel van elke betaling inhouden, of betalingen innen namens restaurants, gebruik dan Stripe Connect.
Instellen#
- Open in de Bedrijfsweergave Financiën → Betalingsintegratie en klik op + op de tegel Stripe.
- Laat bovenaan het formulier Stripe geselecteerd (niet Stripe Connect).
- Vul de velden hieronder in en klik op Opslaan.
- Open in de Locatieweergave Financiën → Betaalmethoden, voeg de betaalmethode Kaart toe of bewerk deze, en kies deze integratie als betalingsverwerker.
| Veld | Wat het is |
|---|---|
| Identificatienaam | Je eigen naam voor de integratie, zichtbaar in lijsten en wanneer je hem bij een betaalmethode kiest. |
| Openbare sleutel | De publieke Stripe-sleutel (pk_live_… of pk_test_…), te vinden in Stripe onder Developers → API keys. |
| Geheime sleutel | De geheime Stripe-sleutel (sk_live_… of sk_test_…) van hetzelfde account. Standaard verborgen; klik op het oogje om hem te tonen. |
| Webhook-ondertekeningsgeheim | Optioneel. Laat het leeg: bij opslaan maakt OrderTiger zijn webhook aan op dit Stripe-account en vult dit veld voor je in. |
| Betalingen automatisch afwikkelen | Aan: de kaart wordt meteen belast zodra de klant betaalt. Uit: het bedrag wordt alleen gereserveerd op de kaart en pas afgeschreven wanneer de bestelling wordt geaccepteerd. Bij vestigingen die bestellingen automatisch bevestigen, wordt altijd direct afgeschreven. |
| Apple Pay / Google Pay | Biedt deze wallets aan bij het afrekenen. Voor Apple Pay moet het domein ook in Stripe geverifieerd zijn. |
| iOS Merchant ID | Het Apple Pay-merchant-ID dat de iOS-bestelapp gebruikt. Alleen zichtbaar voor superbeheerders. |
Hoe een kaartbestelling als betaald wordt gemarkeerd#
Als de klant betaalt, staat de bestelling op Kaart in afwachting totdat Stripe de betaling bevestigt. Stripe doet dat door de webhook van OrderTiger aan te roepen; daarna is de bestelling betaald en verschijnt ze in Live bestellingen.
- De webhook wordt automatisch op het Stripe-account aangemaakt wanneer je de integratie opslaat, en luistert naar
charge.succeeded. Je ziet hem in Stripe onder Developers → Webhooks. - Het ondertekeningsgeheim wordt opgeslagen in Webhook-ondertekeningsgeheim. Is er een geheim opgeslagen, dan accepteert OrderTiger alleen betaalbevestigingen met de handtekening van Stripe. Zonder geheim wordt de bevestiging zonder die controle geaccepteerd.
- Bestond de webhook al toen je opsloeg, dan wordt hij hergebruikt en blijft het veld leeg: Stripe geeft het geheim van een webhook alleen bij het aanmaken. Kopieer het uit de webhook in Stripe (Reveal) en plak het in het veld, of verwijder de webhook in Stripe en sla de integratie opnieuw op.
Terugbetalingen#
Terugbetalingen doe je vanuit Bestellingen, met de terugbetaalknop bij de bestelling. Het bedrag komt van hetzelfde Stripe-account dat de betaling heeft ontvangen en gaat terug naar de kaart van de klant.
- Er zijn geen kosten te verdelen: de hele terugbetaling komt van dat account.
- Stripe geeft zijn eigen transactiekosten niet terug bij een terugbetaling.
- Bij bestellingen van een portalbedrijf vraagt het terugbetaalformulier Is de handelaar aansprakelijk voor deze terugbetaling?. Met gewone Stripe komt het geld altijd van dit Stripe-account; het antwoord bepaalt alleen hoe de terugbetaling op facturen verschijnt: is de handelaar aansprakelijk, dan wordt ze van de inkomsten van het restaurant afgetrokken, is het platform aansprakelijk, dan niet.
- Een terugbetaling kan gedeeltelijk zijn; de bedragen die tot nu toe zijn terugbetaald, staan onder de bestelling.
Problemen oplossen#
| Probleem | Wat je controleert |
|---|---|
| Een betaalde bestelling blijft op Kaart in afwachting staan en komt nooit in Live bestellingen | De bevestiging van Stripe is niet aangekomen. Controleer in Stripe of OrderTiger's webhook onder Developers → Webhooks staat en bekijk de recente afleveringen. Ontbreekt hij, sla de integratie dan opnieuw op om hem aan te maken. |
| Webhook-ondertekeningsgeheim is na het opslaan nog leeg | De webhook bestond al. Plak het geheim uit Stripe in het veld, of verwijder de webhook in Stripe en sla opnieuw op. |
| Betalingen mislukken met een authenticatiefout | De Geheime sleutel en de Openbare sleutel moeten van hetzelfde Stripe-account komen en in dezelfde modus staan (allebei test of allebei live). |