Skip to main content
Een dispute bevat de betwiste betaling, een deadline om te reageren, je bewijs en de uitkomst zodra de verwerker een uitspraak doet. Gebruik de Disputes API om disputes weer te geven, het bewijspakket te bewerken zolang een dispute nog betwistbaar is en het ter beoordeling in te dienen, of om een chargeback te accepteren die je niet wilt betwisten.

Endpoints

Attributen

string
vereist
Dispute-ID, met prefix dspt_.
boolean
vereist
Of de dispute aan de klant kan worden toegegeven met POST /disputes/\{id} /accept. Alleen true voor een chargeback die nog op een reactie wacht, vóór evidence_due_at, waarvan de betalingsverwerker het accepteren van disputes ondersteunt. Navragen kunnen nooit worden geaccepteerd.
string | null
vereist
Het account waartegen de dispute is ingediend, met prefix biz_.
number
vereist
Het betwiste bedrag, in hele eenheden van currency.
object
vereist
De klant die de dispute heeft ingediend.

Eigenschappen

string | null
vereist
Het e-mailadres van de klant. Vereist de scope member:email:read; zonder die scope null.
string | null
vereist
De ledenregel van de klant op het account, met prefix mem_.
string | null
vereist
De weergavenaam van de klant.
string | null
vereist
Het gebruikers-ID van de klant, met prefix user_. null bij een gastcheckout.
string | null
vereist
De Whop-gebruikersnaam van de klant.
string
vereist
Wanneer de dispute is geopend, als ISO 8601-tijdstempel.
string
vereist
ISO-valutacode van drie letters van het betwiste bedrag.
object
vereist
Het bewijspakket dat naar de verwerker wordt gestuurd om de dispute te betwisten.

Eigenschappen

string | null
vereist
Log van de toegang van de klant tot het product, zoals aanmeld- of downloadactiviteit.
string | null
vereist
Het factuuradres dat de klant bij de checkout heeft opgegeven.
object | null
vereist
Het document met het annuleringsbeleid. Standaard het annuleringsbeleid van het account, daarna de servicevoorwaarden, daarna het retourbeleid en daarna het platformbeleid van Whop.

Eigenschappen

string | null
vereist
Het ID van de bijlage. null voor een door Whop gehost beleid, dat geen geüpload bestand is.
string | null
vereist
Het MIME-type van het geüploade bestand.
string | null
vereist
De naam van het geüploade bestand.
boolean
vereist
Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert niets.
string | null
vereist
Een URL om de bijlage te downloaden.
string | null
vereist
Hoe het annuleringsbeleid vóór de aankoop aan de klant is getoond.
object | null
vereist
Correspondentie met de klant, of bewijs dat de klant het product heeft gebruikt.

Eigenschappen

string | null
vereist
Het ID van de bijlage. null voor een door Whop gehost beleid, dat geen geüpload bestand is.
string | null
vereist
Het MIME-type van het geüploade bestand.
string | null
vereist
De naam van het geüploade bestand.
boolean
vereist
Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert niets.
string | null
vereist
Een URL om de bijlage te downloaden.
string | null
vereist
Het e-mailadres dat de klant bij de checkout heeft gebruikt.
string | null
vereist
De naam van de klant zoals opgegeven bij de checkout.
object[]
vereist
Aanvullende bewijsdocumenten, naast de vier vaste plekken — ingesteld via evidence.documents op PATCH /disputes/\{id}. Elk document gaat onder het eigen document_type mee in het ingediende pakket.

Eigenschappen

string
vereist
Het ID van het bestand, met prefix file_.
string | null
vereist
BlurHash-placeholder voor een afbeelding of video. Null wanneer niet beschikbaar of verwijderd door moderatie.
string | null
vereist
Het MIME-type van het geüploade bestand. Uploads zijn beperkt tot de typen die de verwerker accepteert en worden zonder type geweigerd — nooit null.Beschikbare opties: application/pdf, application/json, image/jpeg, image/png, image/webp
string
vereist
Wanneer het bestand is aangemaakt, als ISO 8601-tijdstempel.
string
vereist
Wat dit document bewijst. return_policy, cancellation_policy en terms_of_service zijn de beleidsdocumenten van de verkoper. Een beleidsdocument vervangt voor deze dispute het exemplaar van het account. return_policy, cancellation_policy en customer_communication vervangen ook de overeenkomende vaste bewijsplek. shipping_policy zijn de verzendvoorwaarden van de verkoper. customer_communication is correspondentie met de koper, zoals een supportthread of chatlog. product_image is een foto van het product of de dienst die de koper heeft ontvangen. physical_fulfillment is bewijs dat een fysieke bestelling is verzonden en aangekomen. digital_fulfillment is bewijs dat de koper een digitaal product heeft geopend. customer_order_history zijn de eerdere bestellingen van de koper bij deze verkoper. prior_transactions is de betalingsgeschiedenis van de koper op het hele platform, voor een verweer tegen fraude. customer_session zijn checkoutgegevens, zoals IP-adres, apparaatvingerafdruk, AVS- en CVV-resultaten en het 3D Secure-resultaat. subscription is bewijs over de levenscyclus van het lidmaatschap, zoals verlengingen, annulering en verzonden herinneringen. complete_evidence is het volledige antwoord van de verkoper als één PDF van maximaal 19 pagina’s, en moet het enige document zijn. Whop stuurt een complete_evidence-document naar de verwerker in plaats van elk ander bewijsveld, elke bijlage en elk document.Beschikbare opties: return_policy, shipping_policy, cancellation_policy, terms_of_service, physical_fulfillment, customer_order_history, product_image, prior_transactions, customer_session, digital_fulfillment, subscription, customer_communication, complete_evidence
number | null
vereist
Duur van audio of video in seconden. Null wanneer niet beschikbaar of verwijderd door moderatie.
string | null
vereist
De oorspronkelijke bestandsnaam, inclusief extensie.
integer | null
vereist
Hoogte van afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
integer | null
De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
string | null
Het ID van de multipart-upload, terug te geven aan complete. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.
object[] | null
De vooraf ondertekende URL voor elk deel. Alleen aanwezig bij aanmaken, en alleen voor multipart-uploads.

Eigenschappen

integer
vereist
De op 1 gebaseerde index van dit deel binnen de multipart-upload.
string
vereist
De vooraf ondertekende URL waarnaar de bytes van dit deel met PUT worden verzonden.
string
vereist
Het type van dit object, altijd file.
boolean
vereist
Of moderatie het bestand heeft verwijderd. Bij true levert url een vervangende afbeelding. filename, size en content_type beschrijven nog steeds het originele bestand.
integer | null
vereist
De bestandsgrootte in bytes. null totdat de upload is voltooid.
object
Headers om mee te sturen met de upload-PUT. Alleen aanwezig bij aanmaken.
string
vereist
Waar het bestand zich in de uploadlevenscyclus bevindt.Beschikbare opties: pending, processing, ready, failed
string | null
Vooraf ondertekende URL waarnaar de bytes van het bestand met PUT worden verzonden. Alleen aanwezig bij aanmaken, en alleen voor uploads in één deel.
string | null
vereist
Een URL om het bestand te downloaden. Openbare bestanden krijgen een permanente CDN-URL en privébestanden een ondertekende URL die verloopt. null totdat de upload is voltooid. Wanneer moderatie het bestand verwijdert, een URL van een vervangende afbeelding.
string
vereist
public-bestanden worden geleverd vanaf een niet-ondertekende CDN-URL. private-bestanden worden geleverd vanaf een ondertekende URL die verloopt.Beschikbare opties: public, private
string | null
vereist
URL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door moderatie.
integer | null
vereist
Breedte van afbeelding of video in pixels. Null wanneer niet beschikbaar of verwijderd door moderatie.
string | null
vereist
Eventuele aanvullende context voor de verwerker die de dispute beoordeelt.
string | null
vereist
Wat de klant heeft gekocht, in de eigen woorden van de verkoper.
object | null
vereist
Het document met het terugbetalingsbeleid. Standaard het retourbeleid van het account, daarna de servicevoorwaarden en daarna het platformbeleid van Whop.

Eigenschappen

string | null
vereist
Het ID van de bijlage. null voor een door Whop gehost beleid, dat geen geüpload bestand is.
string | null
vereist
Het MIME-type van het geüploade bestand.
string | null
vereist
De naam van het geüploade bestand.
boolean
vereist
Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert niets.
string | null
vereist
Een URL om de bijlage te downloaden.
string | null
vereist
Hoe het terugbetalingsbeleid vóór de aankoop aan de klant is getoond.
string | null
vereist
Waarom een terugbetaling is geweigerd, wanneer erom werd gevraagd en deze werd afgewezen.
string | null
vereist
Wanneer het product of de dienst is geleverd.
object | null
vereist
Ondersteunend bewijs dat niet in de andere categorieën past.

Eigenschappen

string | null
vereist
Het ID van de bijlage. null voor een door Whop gehost beleid, dat geen geüpload bestand is.
string | null
vereist
Het MIME-type van het geüploade bestand.
string | null
vereist
De naam van het geüploade bestand.
boolean
vereist
Of dit het eigen gehoste beleid van Whop is, dat wordt gebruikt omdat de verkoper er geen heeft geüpload. Het terugsturen hiervan in een PATCH verandert niets.
string | null
vereist
Een URL om de bijlage te downloaden.
string | null
vereist
De deadline om bewijs in te dienen, als ISO 8601-tijdstempel. null wanneer het netwerk de dispute al automatisch heeft afgehandeld (Visa RDR) zonder bewijsronde, of wanneer de verwerker voor deze dispute geen deadline heeft gerapporteerd.
boolean
vereist
Of evidence nog kan worden gewijzigd en ingediend.
string | null
vereist
Waarom het bewijs niet meer kan worden bewerkt. null zolang evidence_editable true is.Beschikbare opties: submitted, response_window_closed, not_contestable
string | null
vereist
Wanneer het bewijs bij de verwerker is ingediend, als ISO 8601-tijdstempel.
object | null
vereist
De disputekosten die aan het account in rekening zijn gebracht, in de valuta waarin ze zijn geïnd. null wanneer fee_charged false is.

Eigenschappen

string
vereist
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld "10.00" is tien dollar. Het is een string zodat geen float het onderweg afrondt.
string
vereist
ISO 4217-valutacode van drie letters, in kleine letters.
integer
vereist
Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving zelf wordt uitgevoerd.
integer
vereist
Hoeveel decimalen er moeten worden GETOOND. Meestal gelijk aan decimals, en bewust niet altijd: COP wordt in centavos afgeschreven maar in hele peso’s geschreven, dus is het 2 en 0. Gebruik dit om het getal in je eigen locale op te maken.
boolean
vereist
Of Whop het account voor deze dispute disputekosten in rekening heeft gebracht. false wanneer de betaling volledig was terugbetaald voordat de dispute werd geopend, bij een Visa RDR-afhandeling en bij een navraag.
boolean
vereist
Of dit een navraag voorafgaand aan een dispute is in plaats van een formele chargeback. Navragen volgen dezelfde levenscyclus maar verplaatsen geen geld, tenzij er een escaleert.
object[]
vereist
Wat de kaartuitgever zei bij het indienen van de dispute. Alleen gevuld wanneer de uitgever opmerkingen aanlevert, en weergegeven in de volgorde waarin ze zijn ontvangen.

Eigenschappen

string | null
vereist
Wanneer de opmerking is ontvangen, als ISO 8601-tijdstempel.
string
vereist
Wat de uitgever schreef, zoals ontvangen.
object[]
vereist
Alles waarvoor de betwiste betaling in rekening bracht, in aankoopvolgorde. product_id en variant_id verwijzen naar het eerste item; latere items in een winkelwagen verschijnen alleen hier. Een betaling die is gedaan voordat items werden vastgelegd, toont het ene item dat de variant impliceert. Leeg wanneer de betaling niet aan een variant is gekoppeld.

Eigenschappen

string | null
vereist
Regelitem-ID, met prefix li_. Null wanneer de betaling van vóór de itemsnapshots is en het item uit de variant van de betaling wordt gelezen.
string | null
vereist
De naam van het item zoals getoond bij de checkout (de producttitel, anders de varianttitel).
string | null
vereist
Het product waartoe de variant behoort, met prefix prod_. Bij een betaling van vóór de itemsnapshots valt dit terug op het product van de variant, dus het kan zijn ingesteld waar de eigen product_id van het bovenliggende object null is. Null voor een variant zonder product.
string | null
vereist
De huidige titel van het product, of null wanneer het item geen product heeft.
number
vereist
Hoeveel eenheden er zijn gekocht.
string | null
vereist
De stock keeping unit van de variant, vrije tekst ingesteld door de verkoper (bijv. TSHIRT-LARGE-BLUE). Accounts waarvoor SKU-achtervoegsels op basis van factureringsreden zijn ingeschakeld, ontvangen deze met een stempel van de reden van de afschrijving: -S voor een eerste abonnementsbetaling, -R voor een verlenging, -C voor een eenmalige aankoop, -U wanneer de eigen metadata van de betaling upsell: true bevat, -F wanneer er niets in rekening is gebracht. Andere factureringsredenen bevatten de kale SKU. null wanneer de variant geen SKU heeft of is verwijderd.
object | null
vereist
Het vastgelegde bedrag voor de volledige hoeveelheid van dit item, vóór kortingen, belasting en kosten, in de aankoopvaluta. Retourneert null wanneer er geen itembedrag is vastgelegd.

Eigenschappen

string
vereist
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld "10.00" is tien dollar. Het is een string zodat geen float het onderweg afrondt.
string
vereist
ISO 4217-valutacode van drie letters, in kleine letters.
integer
vereist
Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving zelf wordt uitgevoerd.
integer
vereist
Hoeveel decimalen er moeten worden GETOOND. Meestal gelijk aan decimals, en bewust niet altijd: COP wordt in centavos afgeschreven maar in hele peso’s geschreven, dus is het 2 en 0. Gebruik dit om het getal in je eigen locale op te maken.
string | null
vereist
De gekochte variant, met prefix plan_. Null wanneer de variant inmiddels is verwijderd.
string | null
vereist
De huidige titel van de variant, of null wanneer de variant is verwijderd of geen titel heeft.
object
vereist
De betaling die wordt betwist.

Eigenschappen

string
vereist
Betalings-ID, met prefix pay_.
number | null
vereist
Wat de klant in rekening is gebracht, in hele eenheden van de valuta van de betaling.
string | null
vereist
Kaartmerk, wanneer de klant met een kaart heeft betaald.
string | null
vereist
Laatste vier cijfers van de kaart, wanneer de klant met een kaart heeft betaald.
string
vereist
Wanneer de betaling is gedaan, als ISO 8601-tijdstempel.
string | null
vereist
ISO-valutacode van drie letters van de betaling. Kan afwijken van de valuta van de dispute wanneer de verwerker in een andere valuta afrekent.
object | null
vereist
Het betaalinstrument waarmee deze betaling is gedaan, opgemaakt voor weergave: het type betaalmethode, een naam voor de koper, de standaard pictogrammenset en de kaartgegevens, inclusief het netwerktransactie-ID dat het account voor de kaart gebruikt, als het een kaart was. Null wanneer de betaling geen methode vermeldt.

Eigenschappen

object | null
vereist
Alleen voor betalingen met kaart, Apple Pay en Google Pay: het netwerk, de laatste vier cijfers, het issuer identification number, de vervaldatum en het netwerktransactie-ID van de kaart.

Eigenschappen

string | null
vereist
De netwerkidentificatie (visa, amex, …), overeenkomend met items in card.networks en opgeslagen kaartbetaalmethoden. Null wanneer de vault het netwerk niet heeft vastgelegd.
number | null
vereist
De vervalmaand van de kaart, 1 tot en met 12. Null wanneer de vault deze niet heeft vastgelegd.
number | null
vereist
Het viercijferige vervaljaar van de kaart. Null wanneer de vault dit niet heeft vastgelegd.
string | null
vereist
Het issuer identification number, ook wel de BIN genoemd: de eerste zes of acht cijfers van de kaart, die de uitgevende bank identificeren. Null wanneer de verwerker dit niet heeft gerapporteerd.
string | null
vereist
De laatste vier cijfers van de kaart, indien vastgelegd.
string | null
vereist
Het netwerktransactie-ID dat dit account voor de kaart gebruikt. Dit is het eigen ID van dit account, afkomstig van de eerste afschrijving of verificatie met aanwezige klant op de kaart, als Whop er een heeft. Anders is het een eerder netwerktransactie-ID voor deze kaart, dat afkomstig kan zijn van een transactie van een ander account of met de kaart is meegebracht. Vermeld het als de voorgaande transactie bij een latere door de merchant geïnitieerde afschrijving van deze kaart bij dit account. Null totdat er een is. Een webhook die wordt verzonden wanneer een betaling voor het eerst wordt vastgelegd, kan null bevatten; haal de betaling op om het te lezen.
string
vereist
Naam van het instrument voor de koper — “Visa •••• 4242” wanneer de kaart bekend is, anders de eigen naam van de methode (“Klarna”).
object
vereist
De standaard pictogrammenset: vierkante en kaartvormen, elk in lichte en donkere kleurvarianten.

Eigenschappen

object
vereist
De tegel met creditcardverhoudingen (48x30).

Eigenschappen

object
vereist
De kleurvariant voor donkere achtergronden.

Eigenschappen

string
vereist
Rasterterugval op de oorspronkelijke grootte van de vorm.
string
vereist
Rasterterugval op dubbele dichtheid.
string
vereist
Rasterterugval op viervoudige dichtheid.
string
vereist
Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
object
vereist
De kleurvariant voor lichte achtergronden.

Eigenschappen

string
vereist
Rasterterugval op de oorspronkelijke grootte van de vorm.
string
vereist
Rasterterugval op dubbele dichtheid.
string
vereist
Rasterterugval op viervoudige dichtheid.
string
vereist
Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
object
vereist
De vierkante tegel (32x32).

Eigenschappen

object
vereist
De kleurvariant voor donkere achtergronden.

Eigenschappen

string
vereist
Rasterterugval op de oorspronkelijke grootte van de vorm.
string
vereist
Rasterterugval op dubbele dichtheid.
string
vereist
Rasterterugval op viervoudige dichtheid.
string
vereist
Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
object
vereist
De kleurvariant voor lichte achtergronden.

Eigenschappen

string
vereist
Rasterterugval op de oorspronkelijke grootte van de vorm.
string
vereist
Rasterterugval op dubbele dichtheid.
string
vereist
Rasterterugval op viervoudige dichtheid.
string
vereist
Het vectorbestand. Gebruik dit bij voorkeur overal waar SVG wordt weergegeven.
number | null
vereist
Alleen voor betaalmethoden in termijnen: in hoeveel betalingen de afschrijving wordt opgesplitst. Data, geen tekst — stel het label aan de clientzijde samen en vertaal het daar.
string
vereist
De identificatie van het type betaalmethode, bijv. card, klarna, apple_pay.
string | null
vereist
Hoe de klant heeft betaald, zoals card of paypal.
string | null
vereist
Verouderd: wordt niet meer gevuld. Altijd null. VEROUDERD: wordt niet meer gevuld. Altijd null.
string | null
vereist
Het product waarvoor de betwiste betaling was, met prefix prod_.
string
vereist
Waarom de klant zegt de betaling te betwisten, genormaliseerd over verwerkers en kaartnetwerken heen. other omvat een reden van de verwerker die Whop nog niet heeft gecategoriseerd.Beschikbare opties: fraudulent, unrecognized, declined_authorization, product_not_received, product_unacceptable, subscription_canceled, credit_not_processed, duplicate, processing_error, documentation_request, bank_cannot_process, other
string | null
vereist
De ruwe redencode van het kaartnetwerk of de verwerker, zoals 10.4. Alleen ter informatie — reason wordt er niet van afgeleid.
string
vereist
needs_response wacht op bewijs (nadat een verwerker een indiening heeft geweigerd, geeft submission_failure_reason de reden); generating_response heeft bewijs bij de verwerker dat nog niet is geaccepteerd; under_review ligt bij de verwerker; won/lost zijn de uitspraken; prevented wordt afgewikkeld zoals lost. De warning_-statussen zijn de niveaus voor navragen. Na evidence_due_at rapporteert een openstaande dispute under_review.Beschikbare opties: needs_response, warning_needs_response, under_review, warning_under_review, generating_response, won, lost, prevented, warning_closed
string | null
vereist
Waarom de betalingsverwerker de laatste indiening heeft geweigerd, in gewone taal (Engels), terwijl de dispute weer in needs_response staat. Los op wat er wordt genoemd en dien opnieuw in. Alleen bij ophalen: dispute.updated meldt de terugkeer naar needs_response; lees dit veld daarna hier.
string
vereist
Wanneer de dispute voor het laatst is gewijzigd, als ISO 8601-tijdstempel.
string | null
vereist
De variant waarop de betwiste betaling is gedaan, met prefix plan_.
Dispute