Marketplaces
Nium for Marketplaces gives you a single platform to replace the patchwork of PSPs, KYC vendors, and payout providers that marketplace operations typically require. With Nium, you can:
- Collect buyer payments from any PSP in local currencies via virtual accounts
- Split commissions automatically — rules you configure, enforced atomically by Nium
- Hold seller funds in multi-currency sub-accounts, one per seller
- Pay out to sellers across 190+ markets via local rails, wallet-to-wallet, or SWIFT
Nium's reconciliation and report engine provides automated reports so your accounting stays accurate within your marketplace.
How it works
Nium uses a three-tier model for marketplaces:
| Tier | Entity | Accounts provisioned |
|---|---|---|
| Platform (you) | Your marketplace entity | Receivables account — where all funds are aggregated from PSPs. Transfer funds to seller MCY accounts and your Fees account. Fees account — where your commission is aggregated. Transfer funds to your bank account from here. |
| Seller | Each of your sellers | MCY account to receive funds from your Receivables account. Sellers can transfer funds to their own bank account or hold them. |
| PSP | Stripe, Adyen, etc. | No account. Nium whitelists PSPs to fund your Receivables virtual account. |
Setup
Marketplace setup
- Sign up with Nium and fetch your API credentials.
- Nium Compliance processes and reviews your request. When approved, your client account is created and a
customerHashIdis assigned. - Three multi-currency accounts are automatically provisioned:
| Wallet | Purpose | Allowed transaction types |
|---|---|---|
| Receivables | Where PSP funds arrive | Payins (from PSP), wallet-to-wallet transfer to seller and fees accounts |
| Fees | Where your commission is held | Wallet-to-wallet transfer from Receivables, payouts to your own bank |
| Base | For returns and refund handling | Payins, payouts, wallet-to-wallet (all types) |
Additional accounts added via the Add Wallet API are automatically treated as Receivables accounts.
PSP whitelisting
Before any PSP can fund your Receivables wallet, Nium Compliance must approve it. The process:
- Provide the list of PSPs you work with (including multiple entities of the same PSP, if applicable).
- Nium Compliance vets and approves each PSP.
- Your Nium CS team notifies you when whitelisting is complete.
If a non-whitelisted PSP sends funds, the transaction is held by Nium and an RFI is raised for you to clarify the payment intent. Once the RFI is resolved, the PSP is whitelisted and funds are credited to your Receivables account.
Seller setup
Onboard sellers via the Customer Onboarding APIs. Each seller is automatically provisioned with a Base account with all transaction types enabled (payins, payouts, wallet-to-wallet).
Nium can run full KYC/KYB for sellers end-to-end under Nium's licenses in 40+ markets, or you can manage the KYC process yourself.
Fund flows
Collection — PSP to Receivables wallet
- Buyer pays on your marketplace.
- Your PSP (Stripe, Adyen, etc.) collects the payment.
- The PSP sweeps funds to the virtual account issued by Nium.
- Nium reconciles and credits your Receivables account.
Virtual accounts can be issued in over 12 local currencies. Funds arrive in the virtual account's currency, avoiding FX loss at collection.
Commission split — Receivables to Fees and Seller wallets
Once funds land in the Receivables wallet:
-
Calculate seller payouts — run your internal commission split engine and provide instructions to Nium, or use Nium's commission split engine for automated instructions.
-
Execute payouts:
- Transfer your commission to your Fees wallet via the Wallet Transfer API.
- Transfer seller payouts to:
- A seller MCY account with Nium via the Wallet Transfer API. Sellers can hold funds or initiate their own payouts via the Create Transfer Money API.
- A seller's bank account directly via the Create Transfer Money API.
Each split records as a discrete transaction visible in your dashboard and via the Transactions API — no month-end reconciliation or mismatched ledgers.
API reference
| Request | Description |
|---|---|
| Create Customer | Onboard your sellers |
| Customer Details | Fetch seller details |
| Issue Virtual Account | Issue a virtual account per currency for PSPs to fund your Receivables account |
| Virtual Account Details | Fetch the virtual account details of your Receivables account |
| Wallet Transfer | Move funds from Receivables to your Fees account or a seller's MCY account |
| Create Transfer Money | Pay out to sellers or from seller accounts to their bank |
| Transaction Details | View transaction details |
For implementation support, contact your Nium account manager.