購入について保護者の承認を求める
1件の購入について、プレイヤーの信頼できる成人に承認を求めます。課金する前にこのAPIを呼び出し、承認が届いてから購入を完了してください。リクエストは `expiresAt` まで保留され、それを過ぎると承認も拒否もできなくなります。 結果は `Transaction.PurchaseApprovalResult` Webhookで届き、`approved`、`denied`、`expired` のいずれかを伴います。Webhookを無期限に待つのではなく、`expiresAt` を期限として扱ってください。 すでに判断待ちの `id` を再送しても安全な無操作となり、保留中のリクエストがそのまま返され、2つ目のリクエストは作成されません。そのため、ネットワーク障害後の再試行で二重に通知されることはありません。 1人のプレイヤーが判断待ちにできる購入は最大20件です。それを超えると、いずれかが解決するまで `INVALID_INPUT` で拒否されます。
Authorization
api-key In: header
Request Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
Response Body
application/json
application/json
curl -X POST "https://example.com/transaction/request-purchase" \ -H "Content-Type: application/json" \ -d '{ "sessionId": "b1a6482d-5242-4b4a-aa88-3fa52595a672", "id": "9d4e2f81-7a3b-4c56-8e90-1f2a3b4c5d6e", "title": "Starter Pack", "description": "500 coins and a cosmetic item", "amount": 499, "currency": "USD" }'{ "id": "2e9b7c41-8d6a-4f23-bc15-3a8e9d0f1b62", "expiresAt": "2026-06-25T16:00:00Z"}{ "error": "INVALID_INPUT", "errorMessage": "The request was missing a sessionId parameter."}セッションの完了済み金銭取引を送信する POST
k-IDセッションについて、完了済みの購入を1件以上送信します。各イベントは、何が購入され、いくらかかり、決済が成立したかを記録します。購入が完了した後にこのAPIを使用してください。継続課金の場合は更新ごとに送信します。 決済が試行されたものの成立しなかった場合は `status` に `failed` を指定してください。これにより保護者が両者を区別できます。 イベントはそれぞれ独立して処理されます。レスポンスにはイベントごとのステータスが含まれます。 * `accepted` - 購入が記録されました。すでに受理済みの `id` を持つイベントを再送しても安全な無操作となり、再び `accepted` として数えられ、二重に記録されることはありません。そのため、ネットワーク障害後の再試行で二重計上されることはありません。 * `rejected` - 購入が検証に失敗しました。`reason` がどのルールに違反したかを示します。 セッションが存在しない場合や無効化されている場合は、バッチ全体が拒否されます。
週次アクティビティダイジェストのテストメールを送信する POST
対象セッションについて、直近7日間の実際のアクティビティデータを使って、連携済みの成人に週次ダイジェストメールを1通生成して送信します。連携作業中にダイジェストをプレビューするための機能です。テストモードでのみ利用でき、ライブモードでの呼び出しは `400` `INVALID_INPUT` エラーで拒否されます。