app_installation.created, kaldırdığında ise app_installation.deleted alır. Her kurulum ayrıca yalnızca uygulamanızın değiştirebileceği iki değer saklar. external_id, kurulumu sisteminizdeki bir kayda bağlar; metadata ise senkronizasyon imleci gibi küçük değerleri tutar.
Whop üzerinden ödeme alan bir mağaza
Bu kılavuz uydurma bir uygulamayı takip eder. Market Lane bir çevrimiçi mağaza oluşturucusudur ve Whop uygulaması, bir işletmenin Market Lane mağazasında Whop üzerinden ödeme almasını sağlar. Her mağazanınriver-coffee gibi bir tanıtıcısı (handle) vardır ve Market Lane’deki her ödeme işlemi bu tanıtıcıyla başlar.
Market Lane’in üç şeyi bilmesi gerekir:
- Bir işletmenin uygulamayı ne zaman kurduğu; böylece işletmenin mağazasını bağlayabilir.
- Bir mağazada ödeme işlemi başladığında ödemeyi hangi Whop hesabının aldığı.
- Bir işletmenin uygulamayı ne zaman kaldırdığı; böylece mağazası ödeme sırasında Whop’u sunmayı bırakır.
1
Uygulamanızın ihtiyaç duyduğu izinleri isteyin
Uygulamanızın izinlerinde, hesapta ödeme yapılandırmaları oluşturmak için
checkout_configuration:create ve bunların ne zaman ödendiğini öğrenmek için webhook_receive:payments isteyin. İşletme, uygulamayı kurduğunda her ikisini de onaylar.2
Uygulamanızın webhook'una abone olun
Hesabınıza değil, uygulamanıza ait bir webhook oluşturun: Anahtarın, uygulamaya sahip olan hesapta
resource_id değerini uygulamanızın kimliği olarak ayarlayın. Bu webhook, uygulamanızı kuran her hesap için kurulum olaylarını ve bu hesapların izin verdiği ödeme olaylarını alır.developer:manage_webhook iznine sahip olması gerekir. Yanıttaki webhook_secret değerini saklayın ve her teslimatı Webhook’lar bölümünde açıklandığı şekilde doğrulayın.Kurulum olaylarını yalnızca uygulamanızın kendi webhook’ları alır. Bir hesabın webhook’ları, o hesapta kurulu uygulamalar için bile bu olayları asla almaz.3
Bir işletme uygulamayı kurduğunda mağazayı bağlayın
app_installation.created, kurulumu data içinde taşır. Zarfın account_id değeri, uygulamayı kuran işletmedir:river-coffee seçtiğinde, Market Lane tanıtıcıyı kurulumda external_id olarak saklar:4
Bir ödeme işlemi başladığında hesabı bulun
Bir alışverişçi Sonuçta en fazla bir kurulum bulunur ve bunun
river-coffee üzerinde ödeme yapar. İstek yalnızca mağaza tanıtıcısını taşır, bu nedenle Market Lane kurulumu external_id ile arar:account.id değeri ödemeyi alan hesaptır. Market Lane, POST /checkout_configurations ile o hesapta bir ödeme yapılandırması oluşturur, kendi sipariş kimliğini metadata içine koyar ve alışverişçiyi purchase_url adresine gönderir. Market Lane, mağaza tanıtıcıları ile Whop hesaplarını eşleyen bir tablo tutmaz, çünkü eşleme kurulumun kendisidir.5
Siparişi ödendi olarak işaretleyin
payment.succeeded aynı webhook’a gelir. Bunun account_id değeri mağazanın işletmesidir ve ödeme, ödeme yapılandırmasındaki metadata değerini taşır; böylece Market Lane siparişi kimliğiyle bulur ve ödendi olarak işaretler.6
İşletme uygulamayı kaldırdığında Whop ödemelerini kapatın
app_installation.deleted, bir işletme uygulamanızı kaldırır kaldırmaz gelir. Market Lane, river-coffee üzerinde ödeme sırasında Whop’u sunmayı hemen bırakır; böylece hiçbir alışverişçi başarısız olacak bir ödeme sayfasına ulaşmaz. Kurulum artık GET /app_installations içinde görünmez ve uygulamanız artık o hesapta işlem yapamaz.7
Yeniden kurulumda yeniden bağlanın
İşletme uygulamayı yeniden kurarsa, başka bir
app_installation.created alırsınız. Bu aynı kurulumdur: id, created_at, external_id ve metadata değerlerinin tümü geri gelir. Market Lane, yükte external_id: "river-coffee" değerini görür ve işletmeden mağazayı yeniden bağlamasını istemeden o mağaza için Whop ödemelerini yeniden açar.Bir kurulumda kendi kimliğinizi saklayın
external_id, uygulamanızın kurulumları arasında benzersizdir. Başka bir kurulumun zaten sahip olduğu bir değeri ayarlamak409döndürür, bu nedenle iki işletme asla aynı mağazayı sahiplenemez. Değerler büyük/küçük harfe duyarlıdır:River-Coffeeveriver-coffeefarklıdır.metadatabirleştirilir. Gönderdiğiniz anahtarlar ayarlanır,nullolarak ayarlanan bir anahtar kaldırılır, göndermediğiniz anahtarlar değişmez ve{}tüm anahtarları temizler. Değerler dizedir.- Kaldırılmış bir kurulum
external_iddeğerini korur. Bir işletmede uygulamanız kaldırılmış durumdayken, uygulamanızın başka hiçbir kurulumu bu değeri alamaz. İşletme uygulamayı yeniden kurarsa, değer de onunla birlikte geri gelir. - Gizli bilgileri saklamayın. Geliştirici hesabınız
metadataveexternal_iddeğerlerini okuyabilir.
Tekrarlanan olayları işleyin
- Tekrarları bekleyin. Bir işletme uygulamanızı kurabilir, kaldırabilir ve yeniden kurabilir. Zaten bildiğiniz bir kurulum için gelen
app_installation.createdolayını yeniden kurulum olarak değerlendirin. - Yinelenenleri
webhook-idile yok sayın. Whop,2xxyanıtı almayan teslimatları yeniden dener ve bir yeniden deneme aynıwebhook-iddeğerini korur.
Kurulumları kimler okuyabilir
Sonraki adımlar
Webhook'lar
İmzaları doğrulayın, yeniden denemeleri işleyin ve tüm olayları görün.
Uygulama Kurulumları API referansı
Uygulama kurulumları için tüm alanlar ve uç noktalar.
Ödeme alın
Ödeme yapılandırmaları oluşturun ve siparişleri
payment.succeeded üzerinden karşılayın.İzinler
Uygulamanızın kurulum sırasında istediği izinleri tanımlayın.

