Skip to main content
Bu kılavuz, Mercor Clone demosunun temelini Whop Rails kullanarak nasıl yeniden oluşturacağınızı gösterir. Temel sayfaları oluşturacak, ödemeleri Checkout öğesiyle bağlayacak ve alt hesaplara ölçekli şekilde ödeme yapacaksınız. Örnek depoyu görmek için Mercor clone deposunu ziyaret edin. Aksi takdirde başlamak için aşağıdaki öğreticiyi takip edin:
Ortam değişkenlerini ayarlayın
Bağımlılıkları yükleyin
Sunucu rotalarınız için tek bir Whop istemcisi oluşturun. SDK, her istekte oluşturulduğu API sürümünü gönderir.

  1. Proje yapısı ve sayfalar

Pazar yeri akışlarını yansıtan bir App Router yapısı (Next.js) oluşturun. İşlere bakiye yüklemek ve işleri yönetmek için işveren sayfaları, ödemeler ve teslimler için kazanan sayfaları ve gerekirse bir yönetici arayüzü ekleyin. Klasör yapısı
Örnek minimal işveren bakiye sayfası
Örnek minimal kazanan ödeme sayfası

  1. Checkout öğesiyle ödeme akışı

Sunucu: ödemeleri işveren hesabına geri bağlamak için satır içi tek seferlik bir varyant ve kendi meta verilerinizle bir Whop checkout yapılandırması oluşturun.
İstemci: bir “Add Funds” modalı açın ve Whop Elements ödeme sayfasını @whop/elements-react ile bağlayın.
Tamamlanan bir ödeme sekmeyi returnUrl adresine yönlendirir, bu yüzden modalın bir tamamlanma geri çağrısına ihtiyacı yoktur. İşverenin bakiyesini aşağıdaki webhook’tan artırın ve returnUrl adresinin işaret ettiği sayfada gösterin. Webhook: imzayı doğrulayın, Whop ödeme olaylarını alın ve payment.succeeded olayında işverenin bakiyesini artırın. data alanının güncel Payment nesnesi olması için webhook’u oluştururken api_version_date değerini sabitleyin; bu nesnede total, ondalık dize biçiminde bir amount içeren bir para nesnesidir.

  1. Alt hesap ödemeleri (hesap kurulumu + ödeme portalı)

Platform hesabınızın altında bir Whop alt hesabı (kazanan hesabı) oluşturun. Kendi kullanıcı kimliğinizi external_id olarak iletmek, yeniden denenen bir oluşturma isteğinin aynı alt hesabı döndürmesini sağlar. Transferleri yönlendirmek için döndürülen kimliği whopId olarak saklayın. Hesabı daha sonra kullanıcı kimliğinizle bulmak için whop.accounts.list({ external_id }) çağrısını yapın.
Whop Elements ile bir ödeme portalı yerleştirin Sunucunuzda kazananın hesabı için bir erişim belirteci oluşturun (bkz. Alt hesap ödemelerini etkinleştirin), ardından cüzdan arayüzlerini bu belirteçle bağlayın:
İş tamamlama: kazananın whopAccountId değerini ve her teslim için bir idempotency anahtarını kullanarak platformdan kazananın alt hesabına para transfer edin.
Mercor tarzı pazar yerinin temeli bu kadar. İşverenler bakiyelerini ödemelerle doldurur, kazananlar ödeme hesaplarını (alt hesaplar) kurar ve tamamlanan işler, platform ücretiniz düşüldükten sonra parayı kazananlara aktarır. Referans depo: Mercor clone