マーケットプレイス
ルール
- マルチベンダーデータモデル:
Userは1つのSellerプロファイルを持つ — 商品はセラーに属し、注文は購入者とセラーを結びつける
- Stripe Connectによる支払い:Connect Expressでセラーをオンボーディング — KYC、税務フォーム、銀行口座を処理
- 手数料:プラットフォーム手数料をパーセンテージで計算 — PaymentIntentsまたはCheckoutセッションで
application_fee_amountを使用
- エスクローフロー:購入時に支払いをキャプチャし、資金を保留、配送確認後または異議申立期間経過後にセラーに送金
- セラーダッシュボード:売上分析、注文管理、商品CRUD、支払履歴を含む独立したレイアウト
- 購入者/セラーレビュー:注文ごとに1件のレビュー、双方向 — 加重平均で評価を集計
- セラーフィルタリング付き検索:検索ファセットにセラー名、評価、所在地を含める
- セラーオンボーディング:マルチステップフロー — ビジネス情報 → Stripe Connect → 商品リスト → 公開開始
パターン
const account = await stripe.accounts.create({
type: "express",
email: seller.email,
metadata: { sellerId: seller.id },
});
const accountLink = await stripe.accountLinks.create({
account: account.id,
refresh_url: `${baseUrl}/seller/onboarding?refresh=true`,
return_url: `${baseUrl}/seller/onboarding/complete`,
type: "account_onboarding",
});
const session = await stripe.checkout.sessions.create({
line_items: [{ price: priceId, quantity: 1 }],
payment_intent_data: {
application_fee_amount: Math.round(price * 0.10),
transfer_data: { destination: seller.stripeAccountId },
},
mode: "payment",
success_url: `${baseUrl}/orders/{CHECKOUT_SESSION_ID}`,
cancel_url: `${baseUrl}/cart`,
});
避けるべきこと
- エスクローなしの直接送金 — 配送確認または異議申立期間が経過するまで資金を保留する
- 全セラーで単一のStripeアカウントを使用 — コンプライアンスのために各セラーに独自のConnectアカウントが必要
- セラーに支払いスケジュールを設定させる — 不正防止のためにプラットフォーム管理の支払いを使用する
- セラーの確認を怠る — 公開開始前にStripe Connectオンボーディングの完了を必須にする
- プラットフォームがセラーの税務を処理する — Stripe Connect Expressがセラーの税務報告を処理する