Stripe
Koppel Stripe met een beperkte sleutel die alleen kan lezen, en voeg daarna een webhook toe zodat nieuwe betalingen meteen verschijnen.
RevGlance leest je Stripe-account via de API van Stripe met een sleutel die je zelf aanmaakt. Het leest betalingen, terugbetalingen, kosten, betwistingen en abonnementen, en brengt nooit iets in rekening, betaalt nooit iets terug en verandert nooit iets.
Voordat je begint
- Je moet eigenaar of beheerder van het bedrijf in RevGlance zijn. Kijkers kunnen geen bronnen toevoegen.
- Gebruik een beperkte sleutel in plaats van je geheime sleutel. RevGlance accepteert beide (
rk_…ofsk_…), maar een beperkte sleutel kan alleen lezen wat jij toestaat. - Sleutels uit de testmodus werken ook, handig voor een eerste blik. Koppel een tweede bron met je live sleutel als je er klaar voor bent.
Koppelen
- Open in het Stripe Dashboard Developers › API keys en kies Create restricted key. Noem hem RevGlance.
- Geef hem Read-toegang tot Balance, Charges, Customers, Disputes, Invoices, Checkout Sessions, Subscriptions en Coupons. Laat al het andere op None staan.
- Maak de sleutel aan en kopieer hem. Hij begint met
rk_live_. - Plak hem onder Beperkte sleutel en kies Stripe koppelen. De eerste synchronisatie leest je hele geschiedenis.
Wat het formulier vraagt
| Veld | Ziet eruit als |
|---|---|
| Beperkte sleutelVersleuteld opgeslagen | rk_live_… |
Het veld Naam is optioneel. Het onderscheidt twee Stripe-accounts binnen één bedrijf.
Voeg de webhook toe
Zonder webhook synchroniseert RevGlance Stripe elk uur. Met een webhook zet een nieuwe betaling, terugbetaling of opzegging binnen enkele seconden een synchronisatie in de wachtrij.
- Open in RevGlance Instellingen › Bronnen, zoek de Stripe-bron, open het menu ervan en kies Webhook. Kopieer de URL.
- Open in Stripe Developers › Webhooks en voeg een endpoint toe met die URL.
- Selecteer de events die je cijfers veranderen:
charge.succeeded,charge.failed,charge.refunded,charge.dispute.closed,customer.subscription.created,customer.subscription.updated,customer.subscription.deletedeninvoice.paid. Elk event werkt: elk event start gewoon een synchronisatie. - Kopieer het signing secret van het endpoint (
whsec_…), plak het onder Ondertekeningsgeheim in RevGlance en sla op.
Wat RevGlance synchroniseert
- Balance transactions: elke betaling, terugbetaling, betwisting en elke Stripe-kostenpost, in de valuta waarin Stripe die heeft afgerekend.
- Mislukte betalingen, voor de metriek mislukte betalingen en Terugwinnen.
- Abonnementen met elke status, met hun klant, items, kortingen en laatste factuur, voor MRR, proefperiodes en opzeggingen. De opzegreden van Stripe en de opmerking van de klant komen mee als Stripe ze heeft.
De eerste synchronisatie leest je hele geschiedenis. Daarna leest elke synchronisatie vanaf drie dagen vóór de vorige, zodat late wijzigingen worden opgepikt, en abonnementen worden elke keer volledig gelezen.
Hoe Stripe wordt geteld
- Betalingen, terugbetalingen en de kosten van Stripe komen uit je balanstransacties, in de valuta waarin Stripe ze heeft verrekend.
- Kaartterugbetalingen tellen op de dag dat Stripe ze registreert. Bankbetalingen (ACH, SEPA en andere lokale methoden) tellen ook; een terugbetaling die de bank terugstuurt verlaagt je terugbetalingen weer.
- Een betwisting telt als terugbetaling wanneer Stripe het geld terugneemt, en de terugbetaling vervalt als je de betwisting wint. De betwistingskosten van Stripe worden als kosten bewaard.
- Kortingscodes op het abonnement en op losse items gaan van de MRR af. Een kortingscode met een vast bedrag telt alleen in de eigen valuta.
- Gepauzeerde en onbetaalde abonnementen tellen als verloop; een achterstallig abonnement blijft meetellen terwijl Stripe de kaart opnieuw probeert.
- Betalingen, terugbetalingen en betwistingen tellen vóór belasting, in het belastingaandeel van hun factuur of Checkout Session. Zonder leestoegang tot Checkout Sessions blijft de belasting op verkopen buiten een factuur inbegrepen.
- Een prijs inclusief belasting telt in de MRR vóór belasting, in het belastingaandeel van de laatste factuur.
- Het pauzeren van de betalingsinning telt als verloop vanaf de dag dat RevGlance het voor het eerst ziet, omdat Stripe het niet dateert.
Zie Hoe we tellen voor de regels die voor elke provider gelden.
Terugwin-e-mails
Terugwinnen linkt een mislukte abonnementsbetaling aan de pagina van de openstaande factuur in Stripe, waar de klant met een nieuwe kaart kan betalen. Is er geen openstaande factuur, dan opent het in plaats daarvan een sessie in het klantportaal van Stripe. Dat alternatief vereist dat het portaal in Stripe aanstaat en dat de sleutel schrijfrechten heeft voor Customer portal-sessies; zonder dat linkt de e-mail naar je eigen pagina om de kaart bij te werken.
Problemen oplossen
- "Plak een geheime of beperkte Stripe-sleutel." De sleutel moet beginnen met
rk_ofsk_. Een publiceerbare sleutel (pk_) kan niets lezen. - "Stripe refused that key." De sleutel is ingetrokken, of heeft geen leestoegang tot Balance.
- "Stripe refused the failed-charge request" of "the subscription request": de sleutel kan Charges of Subscriptions niet lezen. Betalingen worden nog steeds gesynchroniseerd; voeg de ontbrekende toestemming toe en synchroniseer opnieuw.

RevGlance