Uç noktalar
Öznitelikler
İ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.İtirazı açan müşteri.
Özellikler
Özellikler
Müşterinin e-posta adresi.
member:email:read kapsamını gerektirir; bu kapsam olmadan null.İtiraza karşı çıkmak için ödeme işlemcisine gönderilen kanıt paketi.
Özellikler
Özellikler
İ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
Özellikler
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için
null.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.
Müşteriyle yazışmalar veya ürünü kullandıklarına dair kanıt.
Özellikler
Özellikler
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için
null.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.
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
Özellikler
Bir resim veya video için BlurHash yer tutucusu. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
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/webpBu 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_evidenceSaniye cinsinden ses veya video süresi. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
Piksel cinsinden resim veya video yüksekliği. Kullanılamadığında veya moderasyon tarafından kaldırıldığında 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.
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.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.Dosyanın yükleme yaşam döngüsünde nerede olduğu.Kullanılabilir seçenekler:
pending, processing, ready, failedDosyanı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.
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.public dosyalar imzasız bir CDN URL’sinden sunulur. private dosyalar süresi dolan imzalı bir URL’den sunulur.Kullanılabilir seçenekler: public, privateSes dalga formu URL’si. Kullanılamadığında veya moderasyon tarafından kaldırıldığında null.
İade politikası belgesi. Varsayılan olarak hesabın iade politikası, ardından hizmet şartları, ardından Whop’un platform politikası kullanılır.
Özellikler
Özellikler
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için
null.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.
Diğer kategorilere uymayan destekleyici kanıtlar.
Özellikler
Özellikler
Ekin kimliği. Yüklenmiş bir dosya olmayan, Whop tarafından barındırılan bir politika için
null.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.
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.Kanıtın neden artık düzenlenemediği.
evidence_editable true iken null.Kullanılabilir seçenekler: submitted, response_window_closed, not_contestableHesaptan alınan itiraz ücreti, tahsil edildiği para birimi cinsinden.
fee_charged false olduğunda null.Özellikler
Özellikler
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.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.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.
İ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
Özellikler
li_ önekli satır öğesi kimliği. Ödeme öğe anlık görüntülerinden önceyse ve öğe ödemenin varyantından okunuyorsa null.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.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.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
Özellikler
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.İtiraz edilen ödeme.
Özellikler
Özellikler
Ödemenin üç harfli ISO para birimi kodu. Ödeme işlemcisi başka bir para biriminde mutabakat yaptığında itirazın para biriminden farklı olabilir.
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
Özellikler
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
Özellikler
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.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.
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.Alıcıya yönelik araç adı — kart görünür olduğunda “Visa •••• 4242”, aksi takdirde yöntemin kendi adı (“Klarna”).
Standart simge seti: her biri açık ve koyu renk düzenlerinde kare ve kart biçimleri.
Özellikler
Özellikler
Kredi kartı oranlarındaki karo (48x30).
Özellikler
Özellikler
Kare karo (32x32).
Özellikler
Özellikler
Yalnızca taksitli yöntemler: ücretin kaç ödemeye bölündüğü. Metin değil veridir — etiketi istemci tarafında oluşturun ve çevirin.
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, otherHam kart ağı veya ödeme işlemcisi neden kodu, örneğin
10.4. Yalnızca bilgilendirme amaçlıdır — reason bundan türetilmez.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İ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.Dispute

