Endpoints
Attributen
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.De klant die de dispute heeft ingediend.
Eigenschappen
Eigenschappen
Het e-mailadres van de klant. Vereist de scope
member:email:read; zonder die
scope null.Het bewijspakket dat naar de verwerker wordt gestuurd om de dispute te betwisten.
Eigenschappen
Eigenschappen
Log van de toegang van de klant tot het product, zoals aanmeld- of
downloadactiviteit.
Het document met het annuleringsbeleid. Standaard het annuleringsbeleid van het account, daarna de servicevoorwaarden, daarna het retourbeleid en daarna het platformbeleid van Whop.
Eigenschappen
Eigenschappen
Het ID van de bijlage.
null voor een door Whop gehost beleid, dat geen
geüpload bestand is.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.
Correspondentie met de klant, of bewijs dat de klant het product heeft gebruikt.
Eigenschappen
Eigenschappen
Het ID van de bijlage.
null voor een door Whop gehost beleid, dat geen
geüpload bestand is.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.
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
Eigenschappen
BlurHash-placeholder voor een afbeelding of video. Null wanneer niet
beschikbaar of verwijderd door moderatie.
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/webpWat 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_evidenceDuur van audio of video in seconden. Null wanneer niet beschikbaar of
verwijderd door moderatie.
Hoogte van afbeelding of video in pixels. Null wanneer niet beschikbaar of
verwijderd door moderatie.
De grootte in bytes die elk deel (behalve het laatste) moet hebben. Alleen
aanwezig bij aanmaken, en alleen voor multipart-uploads.
Het ID van de multipart-upload, terug te geven aan
complete. Alleen aanwezig
bij aanmaken, en alleen voor multipart-uploads.Of moderatie het bestand heeft verwijderd. Bij
true levert url een
vervangende afbeelding. filename, size en content_type beschrijven nog
steeds het originele bestand.Waar het bestand zich in de uploadlevenscyclus bevindt.Beschikbare opties:
pending, processing, ready, failedVooraf ondertekende URL waarnaar de bytes van het bestand met PUT worden
verzonden. Alleen aanwezig bij aanmaken, en alleen voor uploads in één deel.
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.public-bestanden worden geleverd vanaf een niet-ondertekende CDN-URL. private-bestanden worden geleverd vanaf een ondertekende URL die verloopt.Beschikbare opties: public, privateURL van de audiogolfvorm. Null wanneer niet beschikbaar of verwijderd door
moderatie.
Het document met het terugbetalingsbeleid. Standaard het retourbeleid van het account, daarna de servicevoorwaarden en daarna het platformbeleid van Whop.
Eigenschappen
Eigenschappen
Het ID van de bijlage.
null voor een door Whop gehost beleid, dat geen
geüpload bestand is.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.
Waarom een terugbetaling is geweigerd, wanneer erom werd gevraagd en deze werd
afgewezen.
Ondersteunend bewijs dat niet in de andere categorieën past.
Eigenschappen
Eigenschappen
Het ID van de bijlage.
null voor een door Whop gehost beleid, dat geen
geüpload bestand is.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.
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.Waarom het bewijs niet meer kan worden bewerkt.
null zolang evidence_editable true is.Beschikbare opties: submitted, response_window_closed, not_contestableDe disputekosten die aan het account in rekening zijn gebracht, in de valuta waarin ze zijn geïnd.
null wanneer fee_charged false is.Eigenschappen
Eigenschappen
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld
"10.00"
is tien dollar. Het is een string zodat geen float het onderweg afrondt.Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving
zelf wordt uitgevoerd.
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.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.
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.
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
Eigenschappen
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.De naam van het item zoals getoond bij de checkout (de producttitel, anders de
varianttitel).
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.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.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
Eigenschappen
Het bedrag in hoofdeenheden, als exacte decimale string. Bijvoorbeeld
"10.00"
is tien dollar. Het is een string zodat geen float het onderweg afrondt.Hoeveel decimalen het bedrag heeft. Dit is de precisie waarmee de afschrijving
zelf wordt uitgevoerd.
De gekochte variant, met prefix
plan_. Null wanneer de variant inmiddels is
verwijderd.De betaling die wordt betwist.
Eigenschappen
Eigenschappen
Wat de klant in rekening is gebracht, in hele eenheden van de valuta van de
betaling.
Laatste vier cijfers van de kaart, wanneer de klant met een kaart heeft
betaald.
ISO-valutacode van drie letters van de betaling. Kan afwijken van de valuta van
de dispute wanneer de verwerker in een andere valuta afrekent.
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
Eigenschappen
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
Eigenschappen
De netwerkidentificatie (
visa, amex, …), overeenkomend met items in
card.networks en opgeslagen kaartbetaalmethoden. Null wanneer de vault het
netwerk niet heeft vastgelegd.De vervalmaand van de kaart, 1 tot en met 12. Null wanneer de vault deze niet
heeft vastgelegd.
Het viercijferige vervaljaar van de kaart. Null wanneer de vault dit niet heeft
vastgelegd.
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.
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.Naam van het instrument voor de koper — “Visa •••• 4242” wanneer de kaart
bekend is, anders de eigen naam van de methode (“Klarna”).
De standaard pictogrammenset: vierkante en kaartvormen, elk in lichte en donkere kleurvarianten.
Eigenschappen
Eigenschappen
De tegel met creditcardverhoudingen (48x30).
Eigenschappen
Eigenschappen
De kleurvariant voor donkere achtergronden.
De kleurvariant voor lichte achtergronden.
De vierkante tegel (32x32).
Eigenschappen
Eigenschappen
De kleurvariant voor donkere achtergronden.
De kleurvariant voor lichte achtergronden.
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.
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, otherDe ruwe redencode van het kaartnetwerk of de verwerker, zoals
10.4. Alleen
ter informatie — reason wordt er niet van afgeleid.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_closedWaarom 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.Dispute

