Skip to main content

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:

TierEntityAccounts provisioned
Platform (you)Your marketplace entityReceivables 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.
SellerEach of your sellersMCY account to receive funds from your Receivables account. Sellers can transfer funds to their own bank account or hold them.
PSPStripe, Adyen, etc.No account. Nium whitelists PSPs to fund your Receivables virtual account.

Setup

Marketplace setup

  1. Sign up with Nium and fetch your API credentials.
  2. Nium Compliance processes and reviews your request. When approved, your client account is created and a customerHashId is assigned.
  3. Three multi-currency accounts are automatically provisioned:
WalletPurposeAllowed transaction types
ReceivablesWhere PSP funds arrivePayins (from PSP), wallet-to-wallet transfer to seller and fees accounts
FeesWhere your commission is heldWallet-to-wallet transfer from Receivables, payouts to your own bank
BaseFor returns and refund handlingPayins, payouts, wallet-to-wallet (all types)
note

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:

  1. Provide the list of PSPs you work with (including multiple entities of the same PSP, if applicable).
  2. Nium Compliance vets and approves each PSP.
  3. Your Nium CS team notifies you when whitelisting is complete.
important

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

  1. Buyer pays on your marketplace.
  2. Your PSP (Stripe, Adyen, etc.) collects the payment.
  3. The PSP sweeps funds to the virtual account issued by Nium.
  4. 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:

  1. Calculate seller payouts — run your internal commission split engine and provide instructions to Nium, or use Nium's commission split engine for automated instructions.

  2. Execute payouts:

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

RequestDescription
Create CustomerOnboard your sellers
Customer DetailsFetch seller details
Issue Virtual AccountIssue a virtual account per currency for PSPs to fund your Receivables account
Virtual Account DetailsFetch the virtual account details of your Receivables account
Wallet TransferMove funds from Receivables to your Fees account or a seller's MCY account
Create Transfer MoneyPay out to sellers or from seller accounts to their bank
Transaction DetailsView transaction details

For implementation support, contact your Nium account manager.

LLM-ready documentation:: llms.txt and llms-full.txt