実稼働 API リクエストのフロー
明示的な所有権スコープとトランザクション監査機能を備えたライブ操作の推奨リクエスト順序。
- ユーザーの JWT またはアプリの API キーを認証して取得します。
- 製品を作成または更新するには、
/v1/products(POST,PUT,PATCH);見る 製品 API CRUD そして 多言語の例. - プロダクト ID を使用して支払いからチェックアウトを開始します。
- コールバック/Webhook 署名を受信して検証します (
payment.confirmed+ ミラー検証)。 - トランザクション結果のクエリ
/v1/transaction/statusまたは/v1/transactions- 見る 取引詳細.
必須のヘッダー
Authorization: Bearer <token>
Content-Type: application/json
エラー処理ベースライン
- 一時的な障害 (5xx) を指数バックオフで再試行します。
- 扱う
401/403認証/許可の問題として。 - 扱う
409ビジネス上の競合 (製品削除の阻害要因など) として。 - 追跡可能性のために、トランザクション ID、Webhook イベント ID、およびリクエスト ID をログに記録します。