実稼働 API リクエストのフロー

明示的な所有権スコープとトランザクション監査機能を備えたライブ操作の推奨リクエスト順序。

  1. ユーザーの JWT またはアプリの API キーを認証して取得します。
  2. 製品を作成または更新するには、 /v1/products (POST, PUT, PATCH);見る 製品 API CRUD そして 多言語の例.
  3. プロダクト ID を使用して支払いからチェックアウトを開始します。
  4. コールバック/Webhook 署名を受信して​​検証します (payment.confirmed + ミラー検証)。
  5. トランザクション結果のクエリ /v1/transaction/status または /v1/transactions - 見る 取引詳細.

必須のヘッダー

Authorization: Bearer <token>
Content-Type: application/json

エラー処理ベースライン

  • 一時的な障害 (5xx) を指数バックオフで再試行します。
  • 扱う 401/403 認証/許可の問題として。
  • 扱う 409 ビジネス上の競合 (製品削除の阻害要因など) として。
  • 追跡可能性のために、トランザクション ID、Webhook イベント ID、およびリクエスト ID をログに記録します。