QBitFlow
Get started

Guide

Run a marketplace

Sell for your sellers from your own key, and take your commission. Split on-chain, or withheld from what you hold.

What you'll build

  1. Your platform → QBitFlow API: Invites a seller
  2. QBitFlow API → Your platform: member.joined, once they accept
  3. Your platform → QBitFlow API: Checkout On-Behalf-Of
  4. Customer wallet → Payment contract, on-chain: Pays
  5. Payment contract → Seller's wallet, on-chain: Direct: their share
  6. Payment contract → Your wallet, on-chain: Direct: your commission
  7. Payment contract → Your wallet, on-chain: Held: all of it, your commission withheld
  8. QBitFlow API → Your platform: payment.completed
  9. Your wallet → Seller's wallet, on-chain: Held: you release it later
Blue mark: money, on-chain. The rest moves no funds.
  • Sellers invited, then paid directly or held until you release from the dashboard
  • Checkouts in each seller's name from your own key, your commission on each sale
  • One webhook endpoint for every seller's events, and refunds of their sales

For platforms with sellers, creators or sub-merchants. Each seller is a member with their own space: they accept your invitation with their own account (no OAuth), then you act for them with your key (marketplace). The business side is on the marketplace page.

The steps

  1. Step 1: Set up, as the organizationAn account, test mode, your organization's wallets, an organization API key and one webhook endpoint: what invites sellers, acts for them and hears them.
  2. Step 2: Choose held or direct payouts, and your commissionPay each seller directly from their first sale, or hold their money in your wallet until you release it. Set your commission. Both are chosen per seller, at the invitation.
  3. Step 3: Invite sellersInvite a seller by email with their payout mode and your commission, learn when they accept from member.joined, and keep track of your sellers.
  4. Step 4: Sell for a sellerAct in a seller's space from your own key with On-Behalf-Of: their products, their checkouts, their payments, your commission on each sale.
  5. Step 5: Held funds and their releaseSee what you hold for each seller, and what a seller sees of it. Release it from the dashboard in one transfer, signed with your wallet.
  6. Step 6: Manage sellersChange a seller's commission, trust them so they're paid directly, see their wallets, and remove a seller when they leave.
  7. Step 7: Refunds in a marketplace, then go liveRefund a seller's sale and know who bears it, follow it on your endpoint, then invite your sellers again in live.

Before you start

  • A server that keeps a secret (your API key) and receives HTTPS requests (your webhooks).
  • An organization wallet on each chain you'll sell on (Ethereum, Base and Solana): it receives your commission and holds funds.
  • For test mode, a few email addresses you control: each test seller accepts from a real inbox.