Skip to main content
Bir ödeme gerçekleştikten sonra iki şey olabilir. İadeler, sizin (veya destek ekibinizin) bilerek yaptığı geri ödemelerdir. İtirazlar, alıcının bankasına başvurarak açtığı ters ibrazlardır. Bir itirazın nasıl sonuçlanacağını her zaman kontrol edemezsiniz, ancak kanıtla yanıt verebilirsiniz.
Durum değişikliklerini yoklama yapmadan eşleştirebilmek için refund.created, refund.updated, dispute.created, dispute.updated ve dispute_alert.created olaylarına yönelik webhook’lara abone olun.

İadeler

İadeler, başarılı bir ödemeyi geri alır. Whop bunları orijinal ödeme işlemcisi üzerinden işler. İlgili üyelik durumu otomatik olarak güncellenir.

Bir iade yapın

İadeleri doğrudan refunds kaynağında değil, bir ödeme için oluşturun. payments.refund({ id }) çağırın. Tam iade için partial_amount değerini atlayın, kısmi iade için ise iletin.
Yanıt, güncellenmiş Payment nesnesidir. refunded_amount alanı, iade edilen kümülatif toplamı yansıtır. Bir ödeme için tam tutarına kadar refund çağrısını birden çok kez yapabilirsiniz.
Gerekli izin: payment:manage. Uygulamanızı yayınlamadan önce bunu İzinler kılavuzundan ekleyin.

İadeleri inceleyin

İadeleri sonradan sorgulamanız gerekirse, bunların kendi kaynakları vardır.

İtirazlar

Bir itiraz (ters ibraz), alıcının bankası bir ödemeye itiraz ettiğinde açılır. Banka karar vermeden önce kanıtla yanıt vermek için belirli bir süreniz vardır. Whop itirazı size iletir, siz kanıt gönderirsiniz, banka karar verir ve itiraz kapanır.

Gelen itirazları takip edin

Abone olunacak üç olay:

Listeleyin ve alın

Kanıtla yanıt verin

İtirazlara iki adımda yanıt verilir: kanıtınızı disputes.update ile hazırlayın, ardından disputes.submit ile gönderin. Güncelleme idempotent’tir. Göndermeden önce alanları istediğiniz kadar düzenleyebilirsiniz.

Kanıt alanları

Her alan isteğe bağlıdır, ancak ne kadar çok bilgi sağlarsanız yanıt o kadar güçlü olur. Yaygın olanlar: Ek alanları, yüklenmiş bir dosyayı { id: file.id } olarak alır. Önce Files API üzerinden yükleyin.

İtiraz durumları

İtiraz bir durum makinesi içinde ilerler. İki aşama vardır: erken uyarı aşaması (warning_ önekli, dispute_alert.created ile bildirilen durumlar) ve resmî itiraz aşaması. SDK’nın döndürebileceği tüm durumlar:
Bir itiraz kaybedildiğinde Whop otomatik olarak bir Refund kaydı oluşturmaz ve siz de kendiniz oluşturamazsınız. payments.refund, itiraz edilmiş bir ödemeye yönelik çağrıları This payment has been disputed. Therefore, it cannot be refunded. mesajıyla reddeder. Kaybedilen itirazı doğruluk kaynağı olarak takip edin ve bir refund.created olayı beklemeyin.

İzinler

Bunları İzinler kılavuzundan ekleyin.

Sonraki adımlar

Ödeme kabul edin

Daha sonra iade edeceğiniz veya savunacağınız ödemeleri oluşturan akış.

Webhook'ları dinleyin

İade ve itiraz olaylarına sunucu tarafında tepki verin.

Dosya yükleyin

İtiraz yanıtları için kanıt eklerini yükleyin.

Disputes API referansı

Kaynağın tamamı: alanlar, durumlar ve her uç nokta.