Skip to main content
Bir uygulama kurulumu, uygulamanızın tek bir Whop hesabına yapılmış tek bir kurulumudur. Bir hesap uygulamanızı kurduğunda uygulamanız 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ın river-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:
  1. Bir işletmenin uygulamayı ne zaman kurduğu; böylece işletmenin mağazasını bağlayabilir.
  2. Bir mağazada ödeme işlemi başladığında ödemeyi hangi Whop hesabının aldığı.
  3. 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: 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.
Anahtarın, uygulamaya sahip olan hesapta 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:
Market Lane işletmeye hangi mağazanın bağlanacağını sorar. İşletme 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 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:
Sonuçta en fazla bir kurulum bulunur ve bunun 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 ayarlamak 409 dö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-Coffee ve river-coffee farklıdır.
  • metadata birleştirilir. Gönderdiğiniz anahtarlar ayarlanır, null olarak 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_id değ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 metadata ve external_id değ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.created olayını yeniden kurulum olarak değerlendirin.
  • Yinelenenleri webhook-id ile yok sayın. Whop, 2xx yanıtı almayan teslimatları yeniden dener ve bir yeniden deneme aynı webhook-id değ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.