Pazaryeri
E-ticaret platformunu pazaryerine çevirin. Lunixi Pazaryeri, satıcı yaşam döngüsünün tamamını tek API arkasında sunar: satıcıları (alt bayileri) kaydedin, hosted portal ya da gömülebilir SDK ile onboarding'lerini tamamlatın, tek bir tahsilatı birden çok satıcıya bölün, komisyon kurallarını otomatik uygulayın ve her satıcıyı denetlenebilir bir payout defterinden ödeyin.
Pazaryeri, çekirdek Payment Gateway üzerinde çalışır — split ödemeler; yönlendirme, 3DS, iade ve webhook'ları normal ödemelerle birebir paylaşır. İsteğe yalnızca sellers[] eklersiniz.
Pazaryeri döngüsü
Bu bölümdeki her şey tekrarlanan tek bir döngüdür:
Satıcıları kaydedin
Satıcıları POST /marketplace/dealers ile tek tek oluşturun ya da mevcut satıcı tabanınızı POST /marketplace/dealers/bulk ile (CSV satırları) toplu içe aktarın. Her satıcı APPLICATION onboarding aşamasında başlar.
KYC akışı geliştirmeden onboard edin
Bir onboarding linki üretin (POST /marketplace/dealers/{id}/onboarding-token) ve satıcıya gönderin. Satıcı; başvurusunu, kimlik doğrulamasını (KYC) ve sözleşme imzasını hosted portal üzerinde — ya da gömülebilir marketplace SDK'sıyla kendi sayfanızın içinde — tamamlar. Satıcı APPLICATION → KYC_PENDING → AWAITING_TERMS → CONTRACT_PENDING → COMPLETED aşamalarından geçer — durumu da ACTIVE'e döner.
Komisyon kurallarını tanımlayın
Varsayılan bir komisyon belirleyin; sonra POST /marketplace/commission-rules ile kategori ya da satıcı bazında ezin. Kurallar yüzde veya sabit tutar destekler; herhangi bir değişikliği devreye almadan önce preview endpoint'i ile kuru çalıştırma yapabilirsiniz.
Split ile tahsil edin
Ödemeyi çekirdek ödemeyle birebir aynı şekilde alın — hosted checkout formu ya da API — ve sellers[] ekleyin: hangi alt bayi ne kadar alacak. Lunixi her satıcının uygunluğunu kontrol eder, satıcı bacağı başına komisyon, hold ve net tutarı hesaplar ve kırılımı işlem kaydına yazar.
Takip edin ve ödeyin
GET /marketplace/transactions her split ödemeyi satıcı bacaklarıyla listeler. Payout defteri (GET /marketplace/payout-ledger) her satıcının alacağını izler; payout'ları kaydedin ve tekil ya da toplu olarak "ödendi" işaretleyin. Her aksiyon kurcalamaya-dayanıklı, hash-zincirli audit log'a düşer.
Neler sunuyor
| Yetenek | Sizin için anlamı |
|---|---|
| Satıcı kayıt defteri | Yasal profil, yetkili kişiler ve adresleriyle alt bayiler — tekil oluşturma veya CSV toplu içe aktarım |
| Self-servis onboarding | Hosted portal (altbayi.lunixi.com) veya gömülebilir JS SDK; KYC adımı Lunixi KYC akışına devredilir |
| Split ödeme | Tek tahsilat, çok satıcı — ALL_OR_NOTHING veya PARTIAL_ALLOWED politikaları, para hareket etmeden önce uygunluk denetimi |
| Komisyon motoru | Varsayılan / kategori / satıcı bazlı kurallar, yüzde veya sabit, devreye almadan önce önizlenebilir |
| Payout defteri | Satıcı başına brüt, komisyon, hold ve net; mark-paid iş akışıyla manuel payout kaydı |
| Compliance seviyesinde denetim | Append-only hash-zincirli audit log + bütünlük doğrulama endpoint'i |
Pazaryeri API'sinde tüm tutarlar minor birim (kuruş) cinsindendir: "amount": 10050 = ₺100,50. Satıcı bacağı tutarları (amountMinor) minor birimli string'dir ve toplamları amount'a eşit olmalıdır.
Sonraki adımlar
İlgili
- Payment Gateway genel bakış — yönlendirme, 3DS, capture/refund temelleri
- Checkout Form — marketplace intent'lerinin yeniden kullandığı hosted form
- Webhooks —
payment.*event'leri split ödemelerde de tetiklenir