ゲートウェイキーを PayCore に保存しない
加盟店システムが特定のゲートウェイとメソッドを呼び出し、注文リクエストとともにゲートウェイ認証情報を送信します。
- エンドポイント：POST /api/paycore/pay/{gateway}/{method}
- 認証情報フィールド：gateway_credentials
- 単一ゲートウェイまたはエンジニア主導の統合に最適
2 つの統合モード
ゲートウェイを直接制御するか、PayCore がホストする All-in-One チェックアウトを選択します。
Direct Gateway API はリクエストごとにゲートウェイ認証情報を送信するチーム向けです。Project Checkout API は決済認証情報を PayCore に保存し、プロジェクト API キーだけで注文を作成する加盟店向けです。
直接統合と All-in-One の比較
両方のモードを併用できます。Direct Gateway API は加盟店システム側で最大限の制御を維持し、All-in-One チェックアウトは PayCore をホスト型の決済方法選択画面として使用します。
ゲートウェイキーを保存し、PayCore プロジェクトキーを使用
加盟店は PayCore 決済プロジェクトを作成し、複数のゲートウェイ認証情報を保存します。加盟店システムは注文作成時に PayCore プロジェクト API キーだけを送信します。
- エンドポイント案：POST /api/paycore/checkout
- 認証情報フィールド：project_api_key
- ホスト型 All-in-One 決済ページに最適
All-in-One チェックアウトフロー
加盟店が PayCore 加盟店センターで決済プロジェクトを作成
加盟店が SmilePay、ECPay、PLUS、Stripe などのゲートウェイ認証情報を紐付け
加盟店システムが project_api_key で注文を作成
PayCore が checkout_url を返す
支払者が PayCore チェックアウトで決済方法を選択
PayCore が紐付け済みのゲートウェイ認証情報で実際の決済を作成
ゲートウェイが PayCore Webhook を呼び出す
PayCore が決済ステータスを更新し、加盟店の notify_url へ通知
PayCore開発者センターは公開されています。Direct Gateway API、All-in-One決済プロジェクト、Webhook、エラーコード例を順次追加します。