Skip to main content
Nadat een betaling is gelukt, kunnen er twee dingen gebeuren. Terugbetalingen zijn terugboekingen die jij (of je supportteam) bewust uitvoert. Geschillen zijn chargebacks die de koper bij zijn bank indient. Je hebt niet altijd invloed op de uitkomst van een geschil, maar je kunt reageren met bewijs.
Abonneer je op webhooks voor refund.created, refund.updated, dispute.created, dispute.updated en dispute_alert.created, zodat je statuswijzigingen kunt verwerken zonder te pollen.

Terugbetalingen

Terugbetalingen draaien een geslaagde betaling terug. Whop verwerkt ze via de oorspronkelijke betalingsverwerker. De status van het bijbehorende lidmaatschap wordt automatisch bijgewerkt.

Een terugbetaling uitvoeren

Maak terugbetalingen aan voor een betaling, niet rechtstreeks op de refunds-resource. Roep payments.refund({ id }) aan. Laat partial_amount weg voor een volledige terugbetaling, of geef het door voor een gedeeltelijke.
Het antwoord is het bijgewerkte Payment-object. Het veld refunded_amount geeft het cumulatieve terugbetaalde totaal weer. Je kunt refund meerdere keren aanroepen voor een betaling, tot het volledige bedrag.
Vereiste permissie: payment:manage. Voeg deze toe via de gids over permissies voordat je je app publiceert.

Terugbetalingen bekijken

Terugbetalingen hebben een eigen resource voor als je ze achteraf wilt opzoeken.

Geschillen

Een geschil (chargeback) wordt geopend wanneer de bank van de koper een betaling betwist. Je hebt een bepaalde periode om met bewijs te reageren voordat de bank beslist. Whop stuurt het geschil naar je door, jij dient bewijs in, de bank doet een uitspraak en het geschil wordt gesloten.

Inkomende geschillen in de gaten houden

Drie events om je op te abonneren:

Weergeven en ophalen

Reageren met bewijs

Op geschillen reageer je in twee stappen: zet je bewijs klaar met disputes.update en dien het daarna in met disputes.submit. Update is idempotent. Je kunt velden bewerken totdat je indient.

Bewijsvelden

Elk veld is optioneel, maar hoe meer je aanlevert, hoe sterker je reactie. Veelgebruikte velden: Bijlagevelden accepteren een geüpload bestand als { id: file.id }. Upload eerst via de Files API.

Geschilstatussen

Het geschil doorloopt een state machine. Er zijn twee fasen: de fase van vroegtijdige waarschuwing (statussen met het prefix warning_, zichtbaar via dispute_alert.created) en de fase van het formele geschil. Elke status die de SDK kan teruggeven:
Wanneer een geschil verloren is, maakt Whop niet automatisch een Refund-record aan, en je kunt er zelf ook geen aanmaken. payments.refund weigert aanroepen voor een betwiste betaling met This payment has been disputed. Therefore, it cannot be refunded. Gebruik het verloren geschil als bron van waarheid en verwacht geen refund.created-event.

Permissies

Voeg deze toe via de gids over permissies.

Volgende stappen

Betalingen accepteren

De flow die de betalingen aanmaakt die je later terugbetaalt of verdedigt.

Naar webhooks luisteren

Reageer aan de serverkant op events voor terugbetalingen en geschillen.

Bestanden uploaden

Upload bewijsbijlagen voor reacties op geschillen.

Disputes API-referentie

De volledige resource: velden, statussen en elk endpoint.