Skip to main content
Den indeholder den bestridte betaling, en frist for at svare, dine beviser og udfaldet, når betalingsbehandleren har afgjort sagen. Brug Disputes API’et til at liste tvister, redigere bevispakken, mens en tvist stadig kan bestrides, og indsende den til gennemgang, eller acceptere en chargeback, du ikke ønsker at bestride.

Endpoints

Attributter

string
påkrævet
Tvist-ID med præfikset dspt_.
boolean
påkrævet
Om tvisten kan gives til kunden med POST /disputes/\{id} /accept. Kun sand for en chargeback, der stadig afventer svar, før evidence_due_at, hvis betalingsbehandler understøtter accept af tvister. Forespørgsler kan aldrig accepteres.
string | null
påkrævet
Kontoen, tvisten blev indgivet mod, med præfikset biz_.
number
påkrævet
Det bestridte beløb i hele enheder af currency.
object
påkrævet
Kunden, der indgav tvisten.

Egenskaber

string | null
påkrævet
Kundens e-mailadresse. Kræver scopet member:email:read; null uden det.
string | null
påkrævet
Kundens medlemsrække på kontoen med præfikset mem_.
string | null
påkrævet
Kundens visningsnavn.
string | null
påkrævet
Kundens bruger-ID med præfikset user_. null for en gæste-checkout.
string | null
påkrævet
Kundens Whop-brugernavn.
string
påkrævet
Hvornår tvisten blev åbnet, som et ISO 8601-tidsstempel.
string
påkrævet
Trebogstavs ISO-valutakode for det bestridte beløb.
object
påkrævet
Bevispakken sendt til betalingsbehandleren for at bestride tvisten.

Egenskaber

string | null
påkrævet
Log over kundens adgang til produktet, såsom login- eller downloadaktivitet.
string | null
påkrævet
Faktureringsadressen, kunden angav ved checkout.
object | null
påkrævet
Dokumentet med annulleringspolitikken. Standard er kontoens annulleringspolitik, derefter dens servicevilkår, derefter dens returpolitik og derefter Whops platformspolitik.

Egenskaber

string | null
påkrævet
Vedhæftningens ID. null for en Whop-hostet politik, som ikke er en uploadet fil.
string | null
påkrævet
Den uploadede fils MIME-type.
string | null
påkrævet
Den uploadede fils navn.
boolean
påkrævet
Om dette er Whops egen hostede politik, der træder i stedet, fordi sælgeren ikke har uploadet nogen. At sende den tilbage i en PATCH ændrer intet.
string | null
påkrævet
En URL til at downloade vedhæftningen.
string | null
påkrævet
Hvordan annulleringspolitikken blev vist for kunden før købet.
object | null
påkrævet
Korrespondance med kunden eller bevis på, at de har brugt produktet.

Egenskaber

string | null
påkrævet
Vedhæftningens ID. null for en Whop-hostet politik, som ikke er en uploadet fil.
string | null
påkrævet
Den uploadede fils MIME-type.
string | null
påkrævet
Den uploadede fils navn.
boolean
påkrævet
Om dette er Whops egen hostede politik, der træder i stedet, fordi sælgeren ikke har uploadet nogen. At sende den tilbage i en PATCH ændrer intet.
string | null
påkrævet
En URL til at downloade vedhæftningen.
string | null
påkrævet
E-mailadressen, kunden brugte ved checkout.
string | null
påkrævet
Kundens navn som angivet ved checkout.
object[]
påkrævet
Yderligere bevisdokumenter ud over de fire faste pladser — angives via evidence.documents på PATCH /disputes/\{id}. Hvert dokument indgår i den indsendte pakke under sin document_type.

Egenskaber

string
påkrævet
Filens ID med præfikset file_.
string | null
påkrævet
BlurHash-pladsholder for et billede eller en video. Null, når den ikke er tilgængelig eller er fjernet af moderering.
string | null
påkrævet
Den uploadede fils MIME-type. Uploads er begrænset til de typer, betalingsbehandleren accepterer, og afvises uden en — aldrig null.Tilgængelige muligheder: application/pdf, application/json, image/jpeg, image/png, image/webp
string
påkrævet
Hvornår filen blev oprettet, som et ISO 8601-tidsstempel.
string
påkrævet
Hvad dette dokument beviser. return_policy, cancellation_policy og terms_of_service er sælgerens politikdokumenter. Et politikdokument erstatter kontoens kopi for denne tvist. return_policy, cancellation_policy og customer_communication erstatter også den tilsvarende faste bevisplads. shipping_policy er sælgerens forsendelsesvilkår. customer_communication er korrespondance med køberen, såsom en supporttråd eller chatlog. product_image er et foto af produktet eller tjenesten, køberen modtog. physical_fulfillment er bevis på, at en fysisk ordre blev afsendt og ankom. digital_fulfillment er bevis på, at køberen fik adgang til et digitalt produkt. customer_order_history er køberens tidligere ordrer hos denne sælger. prior_transactions er køberens betalingshistorik på tværs af platformen til et svindelforsvar. customer_session er checkoutdata, såsom IP-adresse, enhedsfingeraftryk, AVS- og CVV-resultater og 3D Secure-resultatet. subscription er bevis på medlemskabets livscyklus, såsom fornyelser, annullering og sendte påmindelser. complete_evidence er sælgerens samlede svar som én PDF på højst 19 sider, og det skal være det eneste dokument. Whop sender et complete_evidence-dokument til betalingsbehandleren i stedet for alle andre bevisfelter, vedhæftninger og dokumenter.Tilgængelige muligheder: 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
påkrævet
Lyd- eller videovarighed i sekunder. Null, når den ikke er tilgængelig eller er fjernet af moderering.
string | null
påkrævet
Det oprindelige filnavn inklusive filtypenavn.
integer | null
påkrævet
Billed- eller videohøjde i pixels. Null, når den ikke er tilgængelig eller er fjernet af moderering.
integer | null
Den bytestørrelse, hver del (undtagen den sidste) skal have. Kun til stede ved oprettelse og kun for multipart-uploads.
string | null
ID’et for multipart-uploadet, som sendes tilbage til complete. Kun til stede ved oprettelse og kun for multipart-uploads.
object[] | null
Den forhåndssignerede URL for hver del. Kun til stede ved oprettelse og kun for multipart-uploads.

Egenskaber

integer
påkrævet
Det 1-baserede indeks for denne del i multipart-uploadet.
string
påkrævet
Den forhåndssignerede URL, som denne dels bytes skal sendes til med PUT.
string
påkrævet
Typen af dette objekt, altid file.
boolean
påkrævet
Om moderering har fjernet filen. Når true, leverer url et erstatningsbillede. filename, size og content_type beskriver stadig den oprindelige fil.
integer | null
påkrævet
Filstørrelsen i bytes. null indtil uploadet er færdigt.
object
Headere, der skal sendes med upload-PUT’en. Kun til stede ved oprettelse.
string
påkrævet
Hvor filen er i sin uploadlivscyklus.Tilgængelige muligheder: pending, processing, ready, failed
string | null
Forhåndssigneret URL, som filens bytes skal sendes til med PUT. Kun til stede ved oprettelse og kun for uploads i én del.
string | null
påkrævet
En URL til at downloade filen. Offentlige filer får en permanent CDN-URL, og private filer får en signeret URL, der udløber. null indtil uploadet er færdigt. Når moderering fjerner filen, en URL til et erstatningsbillede.
string
påkrævet
public filer leveres fra en usigneret CDN-URL. private filer leveres fra en signeret URL, der udløber.Tilgængelige muligheder: public, private
string | null
påkrævet
URL til lydbølgeform. Null, når den ikke er tilgængelig eller er fjernet af moderering.
integer | null
påkrævet
Billed- eller videobredde i pixels. Null, når den ikke er tilgængelig eller er fjernet af moderering.
string | null
påkrævet
Eventuel yderligere kontekst til betalingsbehandleren, der gennemgår tvisten.
string | null
påkrævet
Hvad kunden købte, med sælgerens egne ord.
object | null
påkrævet
Dokumentet med refusionspolitikken. Standard er kontoens returpolitik, derefter dens servicevilkår og derefter Whops platformspolitik.

Egenskaber

string | null
påkrævet
Vedhæftningens ID. null for en Whop-hostet politik, som ikke er en uploadet fil.
string | null
påkrævet
Den uploadede fils MIME-type.
string | null
påkrævet
Den uploadede fils navn.
boolean
påkrævet
Om dette er Whops egen hostede politik, der træder i stedet, fordi sælgeren ikke har uploadet nogen. At sende den tilbage i en PATCH ændrer intet.
string | null
påkrævet
En URL til at downloade vedhæftningen.
string | null
påkrævet
Hvordan refusionspolitikken blev vist for kunden før købet.
string | null
påkrævet
Hvorfor en refusion blev afvist, når der blev anmodet om en, og den blev afslået.
string | null
påkrævet
Hvornår produktet eller tjenesten blev leveret.
object | null
påkrævet
Understøttende beviser, der ikke passer ind i de andre kategorier.

Egenskaber

string | null
påkrævet
Vedhæftningens ID. null for en Whop-hostet politik, som ikke er en uploadet fil.
string | null
påkrævet
Den uploadede fils MIME-type.
string | null
påkrævet
Den uploadede fils navn.
boolean
påkrævet
Om dette er Whops egen hostede politik, der træder i stedet, fordi sælgeren ikke har uploadet nogen. At sende den tilbage i en PATCH ændrer intet.
string | null
påkrævet
En URL til at downloade vedhæftningen.
string | null
påkrævet
Fristen for at indsende beviser som et ISO 8601-tidsstempel. null, når netværket allerede har afgjort tvisten automatisk (Visa RDR) uden en bevisrunde, eller når betalingsbehandleren ikke har rapporteret en frist for denne tvist.
boolean
påkrævet
Om evidence stadig kan ændres og indsendes.
string | null
påkrævet
Hvorfor beviser ikke længere kan redigeres. null mens evidence_editable er true.Tilgængelige muligheder: submitted, response_window_closed, not_contestable
string | null
påkrævet
Hvornår beviserne blev indsendt til betalingsbehandleren, som et ISO 8601-tidsstempel.
object | null
påkrævet
Tvistgebyret opkrævet hos kontoen i den valuta, det blev opkrævet i. null, når fee_charged er false.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen locale ved hjælp af dette.
boolean
påkrævet
Om Whop opkrævede kontoen et tvistgebyr for denne. false, når betalingen blev fuldt refunderet, før tvisten blev åbnet, for en Visa RDR-løsning og for en forespørgsel.
boolean
påkrævet
Om dette er en forespørgsel før tvist frem for en formel chargeback. Forespørgsler følger samme livscyklus, men flytter ingen midler, medmindre en eskalerer.
object[]
påkrævet
Hvad kortudstederen sagde ved indgivelse af tvisten. Kun udfyldt, når udstederen leverer dem, og listet i den rækkefølge, de blev modtaget.

Egenskaber

string | null
påkrævet
Hvornår kommentaren blev modtaget, som et ISO 8601-tidsstempel.
string
påkrævet
Hvad udstederen skrev, som modtaget.
object[]
påkrævet
Alt, hvad den bestridte betaling opkrævede for, i købsrækkefølge. product_id og variant_id angiver den første af disse; en kurvs senere varer vises kun her. En betaling foretaget, før varer blev registreret, lister den enkelte vare, som dens variant indebærer. Tom, når betalingen ikke er knyttet til en variant.

Egenskaber

string | null
påkrævet
Linjeelement-ID med præfikset li_. Null, når betalingen er ældre end varesnapshots, og varen læses fra betalingens variant.
string | null
påkrævet
Varens navn som vist ved checkout (produkttitlen, ellers varianttitlen).
string | null
påkrævet
Produktet, varianten tilhører, med præfikset prod_. På en betaling, der er ældre end varesnapshots, falder dette tilbage til variantens produkt, så det kan være angivet, hvor forælderens egen product_id er null. Null for en variant uden produkt.
string | null
påkrævet
Produktets aktuelle titel eller null, når varen ikke har noget produkt.
number
påkrævet
Hvor mange enheder der blev købt.
string | null
påkrævet
Variantens lagerenhed (SKU), fritekst angivet af sælgeren (f.eks. TSHIRT-LARGE-BLUE). Konti med SKU-suffikser for faktureringsårsag aktiveret modtager den stemplet med årsagen til opkrævningen: -S for en første abonnementsopkrævning, -R for en fornyelse, -C for et engangskøb, -U, når betalingens egne metadata indeholder upsell: true, -F, når intet blev opkrævet. Andre faktureringsårsager har den rene SKU. null, når varianten ikke har nogen SKU eller er blevet slettet.
object | null
påkrævet
Det registrerede beløb for denne vares fulde mængde før rabatter, skat og gebyrer i købsvalutaen. Returnerer null, når der ikke er registreret noget varebeløb.

Egenskaber

string
påkrævet
Beløbet i hovedenheder som en præcis decimalstreng. For eksempel er "10.00" ti dollars. Det er en streng, så ingen float afrunder det undervejs.
string
påkrævet
Trebogstavs ISO 4217-valutakode med små bogstaver.
integer
påkrævet
Hvor mange decimaler beløbet har. Dette er den præcision, selve opkrævningen kører med.
integer
påkrævet
Hvor mange decimaler der skal VISES. Normalt lig med decimals, men bevidst ikke altid: COP opkræves i centavos, men skrives i hele pesos, så det er 2 og 0. Formatér tallet i din egen locale ved hjælp af dette.
string | null
påkrævet
Den købte variant med præfikset plan_. Null, når varianten siden er blevet slettet.
string | null
påkrævet
Variantens aktuelle titel eller null, når varianten er blevet slettet eller ikke har nogen titel.
object
påkrævet
Betalingen, der bestrides.

Egenskaber

string
påkrævet
Betalings-ID med præfikset pay_.
number | null
påkrævet
Hvad kunden blev opkrævet i hele enheder af betalingens valuta.
string | null
påkrævet
Kortmærke, når kunden betalte med kort.
string | null
påkrævet
Kortets sidste fire cifre, når kunden betalte med kort.
string
påkrævet
Hvornår betalingen blev foretaget, som et ISO 8601-tidsstempel.
string | null
påkrævet
Trebogstavs ISO-valutakode for betalingen. Kan afvige fra tvistens valuta, når betalingsbehandleren afregner i en anden valuta.
object | null
påkrævet
Det betalingsinstrument, betalingen blev foretaget med, formet til visning: metodetypen, et købervendt navn, standardikonsættet og kortoplysningerne, inklusive det netværkstransaktions-id, kontoen bruger for kortet, når det var et kort. Null, når betalingen ikke angiver nogen metode.

Egenskaber

object | null
påkrævet
Kun kort-, Apple Pay- og Google Pay-betalinger: kortets netværk, sidste fire cifre, udstederidentifikationsnummer, udløb og netværkstransaktions-id.

Egenskaber

string | null
påkrævet
Netværksidentifikatoren (visa, amex, …), der matcher card.networks-poster og gemte kortbetalingsmetoder. Null, når vaulten ikke registrerede netværket.
number | null
påkrævet
Kortets udløbsmåned, 1 til 12. Null, når vaulten ikke registrerede den.
number | null
påkrævet
Kortets firecifrede udløbsår. Null, når vaulten ikke registrerede det.
string | null
påkrævet
Udstederidentifikationsnummeret, også kaldet BIN: kortets første seks eller otte cifre, som identificerer den udstedende bank. Null, når betalingsbehandleren ikke rapporterede det.
string | null
påkrævet
Kortets sidste fire cifre, når de er registreret.
string | null
påkrævet
Det netværkstransaktions-id, denne konto bruger for kortet. Det er kontoens eget id fra dens første opkrævning eller verifikation med kunden til stede på kortet, når Whop har et. Ellers er det et tidligere netværkstransaktions-id for dette kort, som kan stamme fra en anden kontos transaktion eller være medbragt med kortet. Angiv det som den forudgående transaktion ved en senere forhandlerinitieret opkrævning af dette kort hos denne konto. Null, indtil der findes et. En webhook sendt, når en betaling første gang registreres, kan indeholde null, så hent betalingen for at læse det.
string
påkrævet
Købervendt instrumentnavn — “Visa •••• 4242”, når kortet er kendt, ellers metodens eget navn (“Klarna”).
object
påkrævet
Standardikonsættet: kvadratiske og kortformede, hver i lyse og mørke farvevarianter.

Egenskaber

object
påkrævet
Flisen i kreditkortproportioner (48x30).

Egenskaber

object
påkrævet
Farvevarianten til mørke flader.

Egenskaber

string
påkrævet
Raster-reserve i formens oprindelige størrelse.
string
påkrævet
Raster-reserve i dobbelt tæthed.
string
påkrævet
Raster-reserve i firdobbelt tæthed.
string
påkrævet
Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
object
påkrævet
Farvevarianten til lyse flader.

Egenskaber

string
påkrævet
Raster-reserve i formens oprindelige størrelse.
string
påkrævet
Raster-reserve i dobbelt tæthed.
string
påkrævet
Raster-reserve i firdobbelt tæthed.
string
påkrævet
Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
object
påkrævet
Den kvadratiske flise (32x32).

Egenskaber

object
påkrævet
Farvevarianten til mørke flader.

Egenskaber

string
påkrævet
Raster-reserve i formens oprindelige størrelse.
string
påkrævet
Raster-reserve i dobbelt tæthed.
string
påkrævet
Raster-reserve i firdobbelt tæthed.
string
påkrævet
Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
object
påkrævet
Farvevarianten til lyse flader.

Egenskaber

string
påkrævet
Raster-reserve i formens oprindelige størrelse.
string
påkrævet
Raster-reserve i dobbelt tæthed.
string
påkrævet
Raster-reserve i firdobbelt tæthed.
string
påkrævet
Vektorfilen. Foretræk denne overalt, hvor SVG kan gengives.
number | null
påkrævet
Kun afdragsmetoder: hvor mange betalinger opkrævningen opdeles i. Data, ikke tekst — sammensæt og oversæt etiketten på klientsiden.
string
påkrævet
Identifikatoren for betalingsmetodetypen, f.eks. card, klarna, apple_pay.
string | null
påkrævet
Hvordan kunden betalte, f.eks. card eller paypal.
string | null
påkrævet
Udfaset: udfyldes ikke længere. Altid null. UDFASET: Udfyldes ikke længere. Altid null.
string | null
påkrævet
Produktet, den bestridte betaling var for, med præfikset prod_.
string
påkrævet
Hvorfor kunden siger, at de bestrider, normaliseret på tværs af betalingsbehandlere og kortnetværk. other dækker en årsag fra betalingsbehandleren, som Whop endnu ikke har kategoriseret.Tilgængelige muligheder: 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
påkrævet
Den rå årsagskode fra kortnetværket eller betalingsbehandleren, f.eks. 10.4. Kun til information — reason er ikke afledt af den.
string
påkrævet
needs_response afventer beviser (efter at en betalingsbehandler har afvist en indgivelse, siger submission_failure_reason hvorfor); generating_response har beviser hos betalingsbehandleren, endnu ikke accepteret; under_review er hos betalingsbehandleren; won/lost er afgørelserne; prevented afregnes som lost. warning_-statusser er forespørgselsniveauerne. Efter evidence_due_at rapporterer en åben tvist under_review.Tilgængelige muligheder: needs_response, warning_needs_response, under_review, warning_under_review, generating_response, won, lost, prevented, warning_closed
string | null
påkrævet
Hvorfor betalingsbehandleren afviste den seneste indgivelse, i almindeligt sprog, mens tvisten er tilbage i needs_response. Ret det, der nævnes, og indsend igen. Kun ved hentning: dispute.updated rapporterer skiftet tilbage til needs_response, læs derefter dette her.
string
påkrævet
Hvornår tvisten sidst blev ændret, som et ISO 8601-tidsstempel.
string | null
påkrævet
Varianten, den bestridte betaling blev foretaget på, med præfikset plan_.
Dispute