Marketplace SDK

Pazaryeri işletiyorsanız alt bayilerin (satıcıların) başvurusunu kendi sitenizde toplarsınız. SDK, self-onboarding portalının veri katmanıdır.

Akış

Siz token üretirsiniz  →  bayiye link gönderirsiniz  →  bayi formu doldurur
                                                          │
                                    başvuru → KYC → sözleşme → gönderim

Bayinin Lunixi hesabı olmasına gerek yoktur; oturumu davet token'ı taşır.

Kimlik doğrulama — Bearer değil

⚠️

Marketplace SDK'sı Authorization: Bearer kullanmaz. Oturum X-Marketplace-Token başlığında taşınan bir portal token'ıdır (mp_…). Token'ı siz üretip bayiye ilettiğiniz için, bayinin tarafında saklanacak bir anahtar yoktur.

Kullanım

<script src="https://cdn.lunixi.com/lunixi-loader.min.js"></script>

// Tüm başvuru sihirbazını çizer
await Lunixi.marketplace.mount('#onboarding', {
  token: 'mp_...',   // davet linkinden gelir
});

React ve sihirbaz ekranları ilk mountta tembel yüklenir; headless kullanırsanız bundle'ınıza hiç girmez.

İstemci metotları

Metot	Ne yapar	Uç
`getApplicationStatus()`	Başvurunun bulunduğu adımı döner	`GET /api/v1/marketplace/portal/application`
`submitApplication(payload)`	Başvuru alanlarını gönderir	`POST /api/v1/marketplace/portal/submit`
`getKycHandoff()`	KYC akışına devir bilgisini alır	`GET /api/v1/marketplace/portal/kyc-handoff`
`signContract(payload)`	Sözleşmeyi imzalar	`POST /api/v1/marketplace/portal/sign`
`getToken()`	Aktif oturum token'ını döner	—

KYC devri

Başvuru kimlik doğrulama gerektiren adıma geldiğinde getKycHandoff() size devir bilgisini verir; oradan KYC SDK akışına geçersiniz. İki SDK aynı sayfada birlikte çalışabilir — loader ikisini de yükler.

Bilmeniz gerekenler

🚫

Token'ı e-posta/SMS ile ilettiğiniz için link paylaşılabilir bir sırdır. Süresini kısa tutun, tek bayiye özel üretin, ve başvuru tamamlanınca geçersiz kılın.

⚠️

SDK hata durumunda hata fırlatır — yanıt 2xx değilse code ve status taşıyan bir hata alırsınız (MARKETPLACE_REQUEST_FAILED varsayılan koddur). Sessizce boş sonuç dönmez; sihirbazın adımları arasında bu hataları yakalayıp bayiye anlamlı mesaj gösterin.

İlgili

Web SDK Genel Bakış — loader, modlar, kimlik doğrulama modelleri
KYC SDK — devir sonrası çalışan akış

Portal SDK Genel Bakış