購入に対する親の承認のリクエスト
POST/transaction/request-purchase
プレイヤーの信頼できる大人に、1件の購入の承認を求めます。課金の前にこのエンドポイントを使用し、承認が届いてから購入を完了してください。リクエストはexpiresAtまで保留され、それ以降は承認も拒否もできなくなります。
結果はapproved、denied、expiredのいずれかを含むTransaction.PurchaseApprovalResult Webhookとして届きます。Webhookを無期限に待つのではなく、expiresAtを期限として扱ってください。
すでに判断待ちのidを再送信しても安全な無操作です。保留中のリクエストがそのまま返され、2つ目のリクエストは作成されないため、ネットワーク障害後の再試行で二重に通知されることはありません。
プレイヤーが判断待ちで保持できる購入は最大20件です。それを超えると、いずれかが解決するまで呼び出しはINVALID_INPUTで拒否されます。
Request
Responses
- 200
- 400
承認リクエストが受理されました。
不正なリクエスト - レスポンスボディのerrorフィールドに具体的なコード（INVALID_INPUT、NOT_FOUND、FEATURE_DISABLEDなど）が含まれます。