payment-integration

決済連携

SePay（ベトナムの銀行）、Polar（グローバル SaaS）、Stripe（グローバルなインフラストラクチャ）、Paddle（MoR サブスクリプション）、Creem.io（MoR ＋ ライセンス）による、実運用で実績のある決済処理です。

使用する場面

• 決済ゲートウェイ連携（チェックアウト、決済処理）
• サブスクリプション管理（トライアル、アップグレード、請求）
• Webhook 処理（通知、冪等性）
• QR コード決済（VietQR、NAPAS）
• ソフトウェアライセンス（デバイスのアクティベーション）
• 複数プロバイダーの注文管理
• 収益分配と手数料

プラットフォームの選択

プラットフォーム	最適な用途
SePay	ベトナム市場、VND、銀行振込、VietQR
Polar	グローバル SaaS、サブスクリプション、自動化された特典（GitHub/Discord）
Stripe	エンタープライズ決済、Connect プラットフォーム、カスタムチェックアウト
Paddle	MoR サブスクリプション、グローバルな税務コンプライアンス、解約防止
Creem.io	MoR ＋ ライセンス、収益分配、ノーコードチェックアウト

クイックリファレンス

SePay

• references/sepay/overview.md - 認証、対応銀行
• references/sepay/api.md - エンドポイント、取引
• references/sepay/webhooks.md - セットアップ、検証
• references/sepay/sdk.md - Node.js、PHP、Laravel
• references/sepay/qr-codes.md - VietQR の生成
• references/sepay/best-practices.md - 本番環境向けのパターン

Polar

• references/polar/overview.md - 認証、MoR の概念
• references/polar/products.md - 料金モデル
• references/polar/checkouts.md - チェックアウトのフロー
• references/polar/subscriptions.md - ライフサイクル管理
• references/polar/webhooks.md - イベント処理
• references/polar/benefits.md - 自動配信
• references/polar/sdk.md - 多言語対応 SDK
• references/polar/best-practices.md - 本番環境向けのパターン

Stripe

• references/stripe/stripe-best-practices.md - 連携設計
• references/stripe/stripe-sdks.md - サーバー SDK
• references/stripe/stripe-js.md - Payment Element
• references/stripe/stripe-cli.md - ローカルテスト
• references/stripe/stripe-upgrade.md - バージョンアップグレード
• 外部: https://docs.stripe.com/llms.txt

Paddle

• references/paddle/overview.md - MoR、認証、エンティティ ID
• references/paddle/api.md - 商品、価格、取引
• references/paddle/paddle-js.md - チェックアウトのオーバーレイ／インライン表示
• references/paddle/subscriptions.md - トライアル、アップグレード、一時停止
• references/paddle/webhooks.md - SHA256 検証
• references/paddle/sdk.md - Node、Python、PHP、Go
• references/paddle/best-practices.md - 本番環境向けのパターン
• 外部: https://developer.paddle.com/llms.txt

Creem.io

• references/creem/overview.md - MoR、認証、グローバル対応
• references/creem/api.md - 商品、チェックアウトセッション
• references/creem/checkouts.md - ノーコードリンク、ストアフロント
• references/creem/subscriptions.md - トライアル、シートベース
• references/creem/licensing.md - デバイスのアクティベーション
• references/creem/webhooks.md - 署名検証
• references/creem/sdk.md - Next.js、Better Auth
• 外部: https://docs.creem.io/llms.txt

複数プロバイダー

• references/multi-provider-order-management-patterns.md - 注文の統合、通貨換算

スクリプト

• scripts/sepay-webhook-verify.js - SePay Webhook の検証
• scripts/polar-webhook-verify.js - Polar Webhook の検証
• scripts/checkout-helper.js - チェックアウトセッションの生成

主な機能

プラットフォーム	主な機能
SePay	QR／銀行振込／カード、44 以上のベトナムの銀行、Webhook、2 req/s
Polar	MoR、サブスクリプション、従量課金、特典、300 req/min
Stripe	CheckoutSessions、Billing、Connect、Payment Element
Paddle	MoR、オーバーレイ／インラインチェックアウト、Retain（解約防止）、税務
Creem.io	MoR、ライセンス、収益分配、ノーコードチェックアウト

実装

プラットフォームごとの手順ガイドについては、references/implementation-workflows.md を参照してください。

一般的なフロー: 認証 → 商品 → チェックアウト → Webhook → イベント