← Back to industry scenarios

Industry scenario

Marketplace payment route checklist

What should marketplace operators verify before choosing local payment routes for buyer checkout, seller onboarding, split settlement, and refunds?

Priority markets

Merchant entry sequence

  • Diagram buyer payment, seller balance, platform fee, refund, dispute, reserve, and payout flows before provider screening.
  • Separate providers that handle buyer checkout from those that can support seller onboarding or payout operations.
  • Ask each provider about seller KYB/KYC, prohibited categories, payout-country limits, reporting files, and dispute liability.
  • Run test cases for partial fulfillment, partial refund, seller suspension, chargeback, payout reversal, and negative balance handling.
  • Add local methods only where both buyer checkout and marketplace operations have been reviewed for the target market.

Payment needs

  • Buyer checkout coverage across cards, wallets, instant bank transfers, QR payments, cash vouchers, and mobile money where relevant.
  • Seller onboarding, KYB/KYC, sub-merchant management, payout, refund, dispute, reserve, tax, and reconciliation workflows.
  • Clear distinction between payment acceptance, payment facilitation, wallet, escrow-like behavior, and seller payout services.
  • Reporting that connects buyer order, seller account, commission, refund, dispute, payout batch, settlement currency, and FX.
  • Provider review of marketplace role, regulated goods, platform liability, fund-flow model, seller geographies, and local licensing implications.

Recommended route categories

  • Evaluate PSPs or aggregators that can discuss marketplace fund flows, seller onboarding, and sub-merchant reporting for each target country.
  • Use local acquirer or bank routes where the marketplace needs deeper domestic acquiring discussion, while verifying whether a local entity is needed.
  • Compare international PSP marketplace products against local PSP routes for methods like Pix, SPEI, UPI, QRIS, GCash, M-Pesa, and local cards.
  • For seller payouts, keep payout capability separate from buyer checkout capability and verify each flow independently.
  • Avoid calling a route escrow, wallet, or payment-facilitation compliant unless the provider and legal review confirm the actual regulated role.

Provider selection questions

  • Will you review marketplace for the merchant's exact product model, content category, entity, and buyer countries before integration work starts?
  • Which of the priority markets can be evaluated first for this use case: Brazil, Mexico, Colombia, India, Indonesia?
  • Can the current merchant entity apply for each target country, or should we evaluate a local PSP, global PSP, acquirer, gateway, wallet operator, or merchant-of-record style route?
  • Which customer-facing methods can be considered for one-time payments, recurring payments, payment links, invoices, refunds, and failed-payment recovery in this category?
  • What documents, website disclosures, product descriptions, prohibited-category checks, and compliance review steps are needed before method activation?
  • How do API events and reports represent payment attempts, pending states, captures, refunds, partial refunds, chargebacks, reversals, webhook retries, and manual adjustments?
  • Can reports include merchant order ID, customer or account ID, country, currency, FX fields, fee components, refund status, dispute status, payout or settlement batch, and provider reference?
  • How should operations handle this stated need: Buyer checkout coverage across cards, wallets, instant bank transfers, QR payments, cash vouchers, and mobile money where relevant.?
  • How should finance and support handle this stated need: Seller onboarding, KYB/KYC, sub-merchant management, payout, refund, dispute, reserve, tax, and reconciliation workflows.?
  • Which claims about method availability, settlement, coverage, onboarding, support channels, or compliance status should remain unpublished until confirmed in writing?

Risk and compliance notes

  • Marketplace flows can involve split payments, seller onboarding, buyer checkout, refunds, reserves, platform fees, and payouts that require separate provider review.
  • Seller verification, tax information, prohibited goods, sanctions screening, and payout-country restrictions may limit which participants can transact.
  • Refunds and chargebacks can affect platform revenue, seller balances, reserves, and payout reversals, so ledger ownership must be clear.
  • Local payment method availability for buyers does not automatically establish seller payout availability or split-payment support.
  • High-risk categories, cross-border sellers, dropshipping, digital goods, or services marketplaces may trigger additional review or operational controls.
  • Reconciliation should connect buyer order, seller suborder, platform fee, payout account, refund, reversal, dispute, and settlement batch.
  • Do not claim coverage for sellers in sensitive or unsupported jurisdictions; treat Russia, Venezuela, and Myanmar only as compliance exclusions where relevant.

Suggested internal links