Skip to main content
İtiraz edilen ödemeyi, yanıt verme son tarihini, kanıtlarınızı ve ödeme işlemcisi karar verdiğinde sonucu içerir. İtirazlar API’sini itirazları listelemek, bir itiraza hâlâ karşı çıkılabilirken kanıt paketini düzenleyip incelemeye göndermek veya karşı çıkmak istemediğiniz bir ters ibrazı kabul etmek için kullanın.

Uç noktalar

Öznitelikler

string
gerekli
dspt_ önekli itiraz kimliği.
boolean
gerekli
İtirazın POST /disputes/\{id} /accept ile müşteri lehine kabul edilip edilemeyeceği. Yalnızca evidence_due_at tarihinden önce, hâlâ yanıt bekleyen ve ödeme işlemcisi itiraz kabulünü destekleyen bir ters ibraz için true’dur. Sorgulamalar hiçbir zaman kabul edilemez.
string | null
gerekli
İtirazın açıldığı biz_ önekli hesap.
number
gerekli
currency biriminin tam birimleri cinsinden itiraz edilen tutar.
object
gerekli
İtirazı açan müşteri.

Özellikler

string | null
gerekli
Müşterinin e-posta adresi. member:email:read kapsamını gerektirir; bu kapsam olmadan null.
string | null
gerekli
Müşterinin hesaptaki mem_ önekli üye kaydı.
string | null
gerekli
Müşterinin görünen adı.
string | null
gerekli
Müşterinin user_ önekli kullanıcı kimliği. Misafir ödemesi için null.
string | null
gerekli
Müşterinin Whop kullanıcı adı.
string
gerekli
İtirazın açıldığı zaman, ISO 8601 zaman damgası olarak.
string
gerekli
İtiraz edilen tutarın üç harfli ISO para birimi kodu.
object
gerekli
İtiraza karşı çıkmak için ödeme işlemcisine gönderilen kanıt paketi.

Özellikler

string | null
gerekli
Müşterinin ürüne erişim günlüğü; örneğin oturum açma veya indirme etkinliği.
string | null
gerekli
Müşterinin ödeme sırasında sağladığı fatura adresi.
object | null
gerekli
İptal politikası belgesi. Varsayılan olarak hesabın iptal politikası, ardından hizmet şartları, ardından iade politikası, ardından Whop’un platform politikası kullanılır.

Özellikler

string | null
gerekli
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için null.
string | null
gerekli
Yüklenen dosyanın MIME türü.
string | null
gerekli
Yüklenen dosyanın adı.
boolean
gerekli
Satıcı hiçbir şey yüklemediği için yerine geçen, Whop’un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
string | null
gerekli
Eki indirmek için bir URL.
string | null
gerekli
İptal politikasının satın alma öncesinde müşteriye nasıl gösterildiği.
object | null
gerekli
Müşteriyle yazışmalar veya ürünü kullandıklarına dair kanıt.

Özellikler

string | null
gerekli
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için null.
string | null
gerekli
Yüklenen dosyanın MIME türü.
string | null
gerekli
Yüklenen dosyanın adı.
boolean
gerekli
Satıcı hiçbir şey yüklemediği için yerine geçen, Whop’un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
string | null
gerekli
Eki indirmek için bir URL.
string | null
gerekli
Müşterinin ödeme sırasında kullandığı e-posta adresi.
string | null
gerekli
Müşterinin ödeme sırasında verdiği ad.
object[]
gerekli
Dört sabit alanın ötesindeki ek kanıt belgeleri — PATCH /disputes/\{id} üzerinde evidence.documents ile ayarlanır. Her biri gönderilen pakete kendi document_type değeri altında eklenir.

Özellikler

string
gerekli
file_ önekli dosya kimliği.
string | null
gerekli
Bir resim veya video için BlurHash yer tutucusu. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
string | null
gerekli
Yüklenen dosyanın MIME türü. Yüklemeler ödeme işlemcisinin kabul ettiği türlerle sınırlıdır ve tür olmadan reddedilir — asla null değildir.Kullanılabilir seçenekler: application/pdf, application/json, image/jpeg, image/png, image/webp
string
gerekli
Dosyanın oluşturulduğu zaman, ISO 8601 zaman damgası olarak.
string
gerekli
Bu belgenin neyi kanıtladığı. return_policy, cancellation_policy ve terms_of_service satıcının politika belgeleridir. Bir politika belgesi, bu itiraz için hesabın kopyasının yerini alır. return_policy, cancellation_policy ve customer_communication ayrıca eşleşen sabit kanıt alanının yerini alır. shipping_policy satıcının kargo koşullarıdır. customer_communication alıcıyla yapılan yazışmalardır; örneğin bir destek yazışması veya sohbet günlüğü. product_image, alıcının aldığı ürün veya hizmetin bir fotoğrafıdır. physical_fulfillment, fiziksel bir siparişin gönderildiğinin ve ulaştığının kanıtıdır. digital_fulfillment, alıcının dijital bir ürüne eriştiğinin kanıtıdır. customer_order_history, alıcının bu satıcıdan verdiği geçmiş siparişlerdir. prior_transactions, dolandırıcılık savunması için alıcının platform genelindeki ödeme geçmişidir. customer_session, IP adresi, cihaz parmak izi, AVS ve CVV sonuçları ile 3D Secure sonucu gibi ödeme verileridir. subscription, yenilemeler, iptal ve gönderilen hatırlatmalar gibi üyelik yaşam döngüsü kanıtıdır. complete_evidence, satıcının tüm yanıtını en fazla 19 sayfalık tek bir PDF olarak içerir ve tek belge olmalıdır. Whop, complete_evidence belgesini diğer tüm kanıt alanları, ekler ve belgeler yerine ödeme işlemcisine gönderir.Kullanılabilir seçenekler: 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
gerekli
Saniye cinsinden ses veya video süresi. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
string | null
gerekli
Uzantısı dahil orijinal dosya adı.
integer | null
gerekli
Piksel cinsinden resim veya video yüksekliği. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
integer | null
Her parçanın (sonuncusu hariç) sahip olması gereken bayt boyutu. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.
string | null
complete çağrısına geri iletilen çok parçalı yükleme kimliği. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.
object[] | null
Her parça için önceden imzalanmış URL. Yalnızca oluşturma sırasında ve yalnızca çok parçalı yüklemeler için bulunur.

Özellikler

integer
gerekli
Bu parçanın çok parçalı yükleme içindeki 1 tabanlı dizini.
string
gerekli
Bu parçanın baytlarının PUT ile gönderileceği önceden imzalanmış URL.
string
gerekli
Bu nesnenin türü, her zaman file.
boolean
gerekli
Moderasyonun dosyayı kaldırıp kaldırmadığı. true olduğunda url yerine geçen bir resim sunar. filename, size ve content_type hâlâ orijinal dosyayı tanımlar.
integer | null
gerekli
Bayt cinsinden dosya boyutu. Yükleme tamamlanana kadar null.
object
Yükleme PUT isteğiyle gönderilecek başlıklar. Yalnızca oluşturma sırasında bulunur.
string
gerekli
Dosyanın yükleme yaşam döngüsünde nerede olduğu.Kullanılabilir seçenekler: pending, processing, ready, failed
string | null
Dosyanın baytlarının PUT ile gönderileceği önceden imzalanmış URL. Yalnızca oluşturma sırasında ve yalnızca tek parçalı yüklemeler için bulunur.
string | null
gerekli
Dosyayı indirmek için bir URL. Herkese açık dosyalar kalıcı bir CDN URL’si, özel dosyalar ise süresi dolan imzalı bir URL alır. Yükleme tamamlanana kadar null. Moderasyon dosyayı kaldırdığında, yerine geçen bir resim URL’si.
string
gerekli
public dosyalar imzasız bir CDN URL’sinden sunulur. private dosyalar süresi dolan imzalı bir URL’den sunulur.Kullanılabilir seçenekler: public, private
string | null
gerekli
Ses dalga formu URL’si. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
integer | null
gerekli
Piksel cinsinden resim veya video genişliği. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
string | null
gerekli
İtirazı inceleyen ödeme işlemcisi için ek bağlam.
string | null
gerekli
Müşterinin satın aldığı şey, satıcının kendi ifadesiyle.
object | null
gerekli
İade politikası belgesi. Varsayılan olarak hesabın iade politikası, ardından hizmet şartları, ardından Whop’un platform politikası kullanılır.

Özellikler

string | null
gerekli
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için null.
string | null
gerekli
Yüklenen dosyanın MIME türü.
string | null
gerekli
Yüklenen dosyanın adı.
boolean
gerekli
Satıcı hiçbir şey yüklemediği için yerine geçen, Whop’un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
string | null
gerekli
Eki indirmek için bir URL.
string | null
gerekli
İade politikasının satın alma öncesinde müşteriye nasıl gösterildiği.
string | null
gerekli
Bir iade talep edilip reddedildiğinde, iadenin neden reddedildiği.
string | null
gerekli
Ürünün veya hizmetin teslim edildiği zaman.
object | null
gerekli
Diğer kategorilere uymayan destekleyici kanıtlar.

Özellikler

string | null
gerekli
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için null.
string | null
gerekli
Yüklenen dosyanın MIME türü.
string | null
gerekli
Yüklenen dosyanın adı.
boolean
gerekli
Satıcı hiçbir şey yüklemediği için yerine geçen, Whop’un kendi barındırdığı politika olup olmadığı. Bir PATCH isteğinde geri göndermek hiçbir şeyi değiştirmez.
string | null
gerekli
Eki indirmek için bir URL.
string | null
gerekli
Kanıt göndermek için son tarih, ISO 8601 zaman damgası olarak. Ağ itirazı kanıt aşaması olmadan zaten otomatik olarak çözdüğünde (Visa RDR) veya ödeme işlemcisi bu itiraz için bir son tarih bildirmediğinde null.
boolean
gerekli
evidence değerinin hâlâ değiştirilip gönderilip gönderilemeyeceği.
string | null
gerekli
Kanıtın neden artık düzenlenemediği. evidence_editable true iken null.Kullanılabilir seçenekler: submitted, response_window_closed, not_contestable
string | null
gerekli
Kanıtın ödeme işlemcisine gönderildiği zaman, ISO 8601 zaman damgası olarak.
object | null
gerekli
Hesaptan alınan itiraz ücreti, tahsil edildiği para birimi cinsinden. fee_charged false olduğunda null.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta yuvarlaması olmaması için dize olarak verilir.
string
gerekli
Üç harfli, küçük harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ücretin kendisinin işlendiği hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals ile aynıdır, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı kendi yerel ayarınızda bunu kullanarak biçimlendirin.
boolean
gerekli
Whop’un bunun için hesaptan bir itiraz ücreti alıp almadığı. Ödeme itiraz açılmadan önce tamamen iade edildiğinde, bir Visa RDR çözümlemesi için ve bir sorgulama için false.
boolean
gerekli
Bunun resmi bir ters ibraz yerine itiraz öncesi bir sorgulama olup olmadığı. Sorgulamalar aynı yaşam döngüsünü izler ancak tırmanmadıkça para hareketi yaratmaz.
object[]
gerekli
Kartı çıkaran bankanın itirazı açarken söyledikleri. Yalnızca kartı çıkaran banka bunları sağladığında doldurulur ve alındıkları sırayla listelenir.

Özellikler

string | null
gerekli
Yorumun alındığı zaman, ISO 8601 zaman damgası olarak.
string
gerekli
Kartı çıkaran bankanın yazdığı, alındığı şekliyle.
object[]
gerekli
İtiraz edilen ödemenin ücretlendirdiği her şey, satın alma sırasına göre. product_id ve variant_id bunların ilkini belirtir; bir sepetin sonraki öğeleri yalnızca burada görünür. Öğeler kaydedilmeye başlanmadan önce yapılan bir ödeme, varyantının ima ettiği tek öğeyi listeler. Ödeme bir varyanta bağlı değilse boştur.

Özellikler

string | null
gerekli
li_ önekli satır öğesi kimliği. Ödeme öğe anlık görüntülerinden önceyse ve öğe ödemenin varyantından okunuyorsa null.
string | null
gerekli
Öğenin ödeme sırasında gösterilen adı (ürün başlığı, yoksa varyant başlığı).
string | null
gerekli
Varyantın ait olduğu prod_ önekli ürün. Öğe anlık görüntülerinden önceki bir ödemede bu, varyantın ürününe geri döner; bu nedenle üst öğenin kendi product_id değeri null olduğu yerde ayarlanmış olabilir. Ürünü olmayan bir varyant için null.
string | null
gerekli
Ürünün güncel başlığı veya öğenin ürünü yoksa null.
number
gerekli
Kaç adet satın alındığı.
string | null
gerekli
Varyantın stok tutma birimi; satıcı tarafından ayarlanan serbest metin (ör. TSHIRT-LARGE-BLUE). Faturalandırma nedeni SKU sonekleri etkin olan hesaplar, ücretin neden alındığını belirten bir ekle birlikte alır: ilk abonelik ücreti için -S, yenileme için -R, tek seferlik satın alma için -C, ödemenin kendi meta verileri upsell: true içerdiğinde -U, hiçbir ücret alınmadığında -F. Diğer faturalandırma nedenleri yalın SKU’yu taşır. Varyantın SKU’su yoksa veya silinmişse null.
object | null
gerekli
Bu öğenin tam miktarı için indirimler, vergi ve ücretlerden önce, satın alma para birimi cinsinden kaydedilen tutar. Hiçbir öğe tutarı kaydedilmediyse null döndürür.

Özellikler

string
gerekli
Ana birim cinsinden tutar, tam bir ondalık dize olarak. Örneğin "10.00" on dolardır. Aktarım sırasında hiçbir kayan nokta yuvarlaması olmaması için dize olarak verilir.
string
gerekli
Üç harfli, küçük harfli ISO 4217 para birimi kodu.
integer
gerekli
Tutarın kaç ondalık basamak taşıdığı. Bu, ücretin kendisinin işlendiği hassasiyettir.
integer
gerekli
Kaç ondalık basamağın GÖSTERİLECEĞİ. Genellikle decimals ile aynıdır, ancak bilinçli olarak her zaman değil: COP centavo cinsinden tahsil edilir ancak tam peso olarak yazılır, bu nedenle 2 ve 0 olur. Sayıyı kendi yerel ayarınızda bunu kullanarak biçimlendirin.
string | null
gerekli
Satın alınan plan_ önekli varyant. Varyant o zamandan beri silinmişse null.
string | null
gerekli
Varyantın güncel başlığı veya varyant silinmişse ya da başlığı yoksa null.
object
gerekli
İtiraz edilen ödeme.

Özellikler

string
gerekli
pay_ önekli ödeme kimliği.
number | null
gerekli
Müşteriden alınan ücret, ödemenin para biriminin tam birimleri cinsinden.
string | null
gerekli
Müşteri kartla ödeme yaptığında kart markası.
string | null
gerekli
Müşteri kartla ödeme yaptığında kartın son dört hanesi.
string
gerekli
Ödemenin yapıldığı zaman, ISO 8601 zaman damgası olarak.
string | null
gerekli
Ödemenin üç harfli ISO para birimi kodu. Ödeme işlemcisi başka bir para biriminde mutabakat yaptığında itirazın para biriminden farklı olabilir.
object | null
gerekli
Bu ödemenin yapıldığı araç, görüntüleme için biçimlendirilmiş: yöntem türü, alıcıya yönelik bir ad, standart simge seti ve kartsa hesabın kart için kullandığı ağ işlem kimliği dahil kart bilgileri. Ödeme hiçbir yöntem belirtmiyorsa null.

Özellikler

object | null
gerekli
Yalnızca Kart, Apple Pay ve Google Pay ödemeleri: kartın ağı, son dört hanesi, kartı çıkaran kuruluş tanımlama numarası, son kullanma tarihi ve ağ işlem kimliği.

Özellikler

string | null
gerekli
card.networks girişleri ve kayıtlı kart ödeme yöntemleriyle eşleşen ağ tanımlayıcısı (visa, amex, …). Kasa ağı kaydetmediyse null.
number | null
gerekli
Kartın son kullanma ayı, 1 ile 12 arası. Kasa bunu kaydetmediyse null.
number | null
gerekli
Kartın dört haneli son kullanma yılı. Kasa bunu kaydetmediyse null.
string | null
gerekli
BIN olarak da adlandırılan kartı çıkaran kuruluş tanımlama numarası: kartı çıkaran bankayı tanımlayan, kartın ilk altı veya sekiz hanesi. Ödeme işlemcisi bunu bildirmediyse null.
string | null
gerekli
Yakalandığında kartın son dört hanesi.
string | null
gerekli
Bu hesabın kart için kullandığı ağ işlem kimliği. Whop’ta varsa, bu hesabın kart üzerindeki ilk müşterinin hazır bulunduğu ücretinden veya doğrulamasından gelen kendi kimliğidir. Aksi takdirde bu kart için daha önceki bir ağ işlem kimliğidir; başka bir hesabın işleminden gelebilir veya kartla birlikte getirilmiş olabilir. Bu kartın bu hesapta daha sonraki satıcı tarafından başlatılan bir ücretinde önceki işlem olarak buna atıfta bulunun. Bir tane olana kadar null. Bir ödeme ilk kaydedilirken gönderilen bir webhook null taşıyabilir; bu nedenle okumak için ödemeyi alın.
string
gerekli
Alıcıya yönelik araç adı — kart görünür olduğunda “Visa •••• 4242”, aksi takdirde yöntemin kendi adı (“Klarna”).
object
gerekli
Standart simge seti: her biri açık ve koyu renk düzenlerinde kare ve kart biçimleri.

Özellikler

object
gerekli
Kredi kartı oranlarındaki karo (48x30).

Özellikler

object
gerekli
Koyu yüzeyler için renk düzeni.

Özellikler

string
gerekli
Biçimin doğal boyutunda raster yedek.
string
gerekli
Çift yoğunlukta raster yedek.
string
gerekli
Dört kat yoğunlukta raster yedek.
string
gerekli
Vektör dosyası. SVG’nin işlendiği her yerde bunu tercih edin.
object
gerekli
Açık yüzeyler için renk düzeni.

Özellikler

string
gerekli
Biçimin doğal boyutunda raster yedek.
string
gerekli
Çift yoğunlukta raster yedek.
string
gerekli
Dört kat yoğunlukta raster yedek.
string
gerekli
Vektör dosyası. SVG’nin işlendiği her yerde bunu tercih edin.
object
gerekli
Kare karo (32x32).

Özellikler

object
gerekli
Koyu yüzeyler için renk düzeni.

Özellikler

string
gerekli
Biçimin doğal boyutunda raster yedek.
string
gerekli
Çift yoğunlukta raster yedek.
string
gerekli
Dört kat yoğunlukta raster yedek.
string
gerekli
Vektör dosyası. SVG’nin işlendiği her yerde bunu tercih edin.
object
gerekli
Açık yüzeyler için renk düzeni.

Özellikler

string
gerekli
Biçimin doğal boyutunda raster yedek.
string
gerekli
Çift yoğunlukta raster yedek.
string
gerekli
Dört kat yoğunlukta raster yedek.
string
gerekli
Vektör dosyası. SVG’nin işlendiği her yerde bunu tercih edin.
number | null
gerekli
Yalnızca taksitli yöntemler: ücretin kaç ödemeye bölündüğü. Metin değil veridir — etiketi istemci tarafında oluşturun ve çevirin.
string
gerekli
Ödeme yöntemi türü tanımlayıcısı, örneğin card, klarna, apple_pay.
string | null
gerekli
Müşterinin nasıl ödediği, örneğin card veya paypal.
string | null
gerekli
Kullanımdan kaldırıldı: artık doldurulmuyor. Her zaman null. KULLANIMDAN KALDIRILDI: Artık doldurulmuyor. Her zaman null.
string | null
gerekli
İtiraz edilen ödemenin ait olduğu prod_ önekli ürün.
string
gerekli
Müşterinin itiraz etme nedeni olarak belirttiği şey, ödeme işlemcileri ve kart ağları genelinde normalleştirilmiş. other, Whop’un henüz kategorize etmediği bir ödeme işlemcisi nedenini kapsar.Kullanılabilir seçenekler: 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
gerekli
Ham kart ağı veya ödeme işlemcisi neden kodu, örneğin 10.4. Yalnızca bilgilendirme amaçlıdır — reason bundan türetilmez.
string
gerekli
needs_response kanıt bekler (bir ödeme işlemcisi bir başvuruyu reddettikten sonra submission_failure_reason nedenini belirtir); generating_response kanıtı ödeme işlemcisindedir, henüz kabul edilmemiştir; under_review ödeme işlemcisindedir; won/lost kararlardır; prevented, lost gibi sonuçlanır. warning_ durumları sorgulama kademeleridir. evidence_due_at geçtikten sonra açık bir itiraz under_review bildirir.Kullanılabilir seçenekler: needs_response, warning_needs_response, under_review, warning_under_review, generating_response, won, lost, prevented, warning_closed
string | null
gerekli
İtiraz yeniden needs_response durumundayken, ödeme işlemcisinin son başvuruyu neden reddettiği, sade bir dille. Belirtilen sorunu düzeltin ve yeniden gönderin. Yalnızca alma işleminde: dispute.updated, needs_response durumuna geri dönüşü bildirir; ardından bunu buradan okuyun.
string
gerekli
İtirazın son değiştirildiği zaman, ISO 8601 zaman damgası olarak.
string | null
gerekli
İtiraz edilen ödemenin yapıldığı plan_ önekli varyant.
Dispute