Marketplace
Turn your e-commerce platform into a marketplace. Lunixi Marketplace gives you the full seller lifecycle behind one API: register sellers (sub-dealers), onboard them through a hosted portal or an embeddable SDK, split a single charge across multiple sellers, apply commission rules automatically, and settle each seller from an auditable payout ledger.
Marketplace runs on top of the core Payment Gateway — split payments share the same routing, 3DS, refunds and webhooks as regular payments. You only add sellers[] to the request.
The marketplace loop
Everything in this section is one repeating cycle:
Register sellers
Create sellers one by one with POST /marketplace/dealers, or import your existing seller base in bulk with POST /marketplace/dealers/bulk (CSV rows). Each seller starts at the APPLICATION onboarding stage.
Onboard them — without building a KYC flow
Mint an onboarding link (POST /marketplace/dealers/{id}/onboarding-token) and send it to the seller. They complete their application, identity verification (KYC) and contract signature on the hosted portal — or inside your own page via the embeddable marketplace SDK. The seller moves APPLICATION → KYC_PENDING → AWAITING_TERMS → CONTRACT_PENDING → COMPLETED — and its status flips to ACTIVE.
Define commission rules
Set a default commission, then override it per category or per seller with POST /marketplace/commission-rules. Rules support percentage or fixed amounts, and you can dry-run any change with the preview endpoint before it takes effect.
Charge with split
Take a payment exactly like a core payment — hosted checkout form or API — and add sellers[]: which sub-dealer gets how much. Lunixi checks each seller's eligibility, computes commission, hold and net per seller leg, and records the breakdown on the transaction.
Track and pay out
GET /marketplace/transactions lists every split payment with its seller legs. The payout ledger (GET /marketplace/payout-ledger) tracks what each seller is owed; record payouts and mark them paid — individually or in bulk. Every action lands in a tamper-evident, hash-chained audit log.
What you get
| Capability | What it means for you |
|---|---|
| Seller registry | Sub-dealers with legal profile, authorized persons and addresses — single create or CSV bulk import |
| Self-service onboarding | Hosted portal (altbayi.lunixi.com) or embeddable JS SDK; KYC hands off to the Lunixi KYC flow |
| Split payments | One charge, many sellers — ALL_OR_NOTHING or PARTIAL_ALLOWED policies, eligibility enforced before money moves |
| Commission engine | Default / category / per-seller rules, percentage or fixed, previewable before activation |
| Payout ledger | Per-seller gross, commission, hold and net; manual payout recording with mark-paid workflow |
| Compliance-grade audit | Append-only hash-chained audit log with an integrity verification endpoint |
All amounts across the Marketplace API are expressed in minor units (kuruş): "amount": 10050 means ₺100.50. Seller leg amounts (amountMinor) are minor-unit strings and must add up to amount.
Where to go next
Related
- Payment Gateway overview — routing, 3DS, capture/refund fundamentals
- Checkout Form — the hosted form that marketplace intents reuse
- Webhooks —
payment.*events fire for split payments too