01 / ワークフロー
すべてのイベントで業務参照を保持
決済、プレイヤーまたは注文、精算の記録が最初から参照を共有すると、連携を運用しやすくなります。
- 01
セッションを作成
最新文書に記載されたリクエスト形式で、必要な金額、通貨、業務参照、戻り情報を送信します。
- 02
決済体験を表示
そのセッションに返された設定済みチェックアウトまたは決済リンクへ顧客を案内します。
- 03
文書化されたイベントを処理
最新のAPI文書に記載されたイベント種別と項目を検証して処理します。
- 04
残高反映して照合
決済参照を使って、イベント、対象プレイヤーまたは注文、反映額、精算記録を関連付けます。
02 / 運用
運用に影響する連携上の選択
有用な連携はチェックアウトを開くだけではありません。事業者が稼働後に必要とする参照、ステータス、失敗経路を保持します。
参照の設計
事業者システムとPayfux記録の両方で見つけられる、一貫したプレイヤー、注文、請求書参照を選びます。
イベント処理
文書化されたイベント項目とステータスだけを処理し、受信した参照を監査と照合のため保持します。
戻り動作
顧客の戻りを画面遷移として扱い、決済または精算完了の最終証拠とはみなしません。
照合経路
事業者のシステム内で決済記録と精算記録を接続し、参照によって差異を調査できるようにします。
03 / 要件
最新文書が優先されます
マーケティング上の例は連携手順を説明しますが、本番エンドポイント、ペイロード、署名、再試行、ステータス値、サービスレベルを定義しません。
- 顧客環境向けに提供された最新API文書に記載された認証とリクエスト項目のみを使用してください。
- ブラウザーの戻りを正式な決済証拠とみなさず、文書化されたサーバー側ステータスとイベントモデルを使用してください。
- 失敗、重複、遅延、ステータス変更の処理を、連携用に文書化された動作に照らしてテストしてください。
04 / 質問
事業者からよく寄せられる質問
最新のPayfux APIスキーマはどこにありますか？
最新スキーマ、認証要件、リクエスト項目はPayfux API文書にあります。製品ページのコード例は説明用であり、正式文書に代わるものではありません。
ブラウザーが戻った時点で決済を完了にすべきですか？
いいえ。顧客の戻りは画面遷移です。事業者は、残高反映と照合に文書化されたサーバー側の決済ステータスとイベント証拠を使用してください。
Payfuxはイベント再試行の特定スケジュールを約束しますか？
このページでは再試行スケジュールを表明していません。最新の顧客文書に記載されたイベントと復旧動作を実装してください。
事業者はどの業務参照を送信すべきですか？
文書化された連携で必要な一貫したプレイヤー、顧客、請求書、注文の参照を使用し、事業者システムに保持してください。
テスト記録と本番記録は共用できますか？
いいえ。環境ごとの認証情報、エンドポイント、記録、照合を分け、文書に記載された環境管理に従ってください。