Endpoints取引

購入について保護者の承認を求める

1件の購入について、プレイヤーの信頼できる成人に承認を求めます。課金する前にこのAPIを呼び出し、承認が届いてから購入を完了してください。リクエストは `expiresAt` まで保留され、それを過ぎると承認も拒否もできなくなります。 結果は `Transaction.PurchaseApprovalResult` Webhookで届き、`approved`、`denied`、`expired` のいずれかを伴います。Webhookを無期限に待つのではなく、`expiresAt` を期限として扱ってください。 すでに判断待ちの `id` を再送しても安全な無操作となり、保留中のリクエストがそのまま返され、2つ目のリクエストは作成されません。そのため、ネットワーク障害後の再試行で二重に通知されることはありません。 1人のプレイヤーが判断待ちにできる購入は最大20件です。それを超えると、いずれかが解決するまで `INVALID_INPUT` で拒否されます。

POST
/transaction/request-purchase
AuthorizationBearer <token>

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"}

セッションの完了済み金銭取引を送信する POST

k-IDセッションについて、完了済みの購入を1件以上送信します。各イベントは、何が購入され、いくらかかり、決済が成立したかを記録します。購入が完了した後にこのAPIを使用してください。継続課金の場合は更新ごとに送信します。 決済が試行されたものの成立しなかった場合は `status` に `failed` を指定してください。これにより保護者が両者を区別できます。 イベントはそれぞれ独立して処理されます。レスポンスにはイベントごとのステータスが含まれます。 * `accepted` - 購入が記録されました。すでに受理済みの `id` を持つイベントを再送しても安全な無操作となり、再び `accepted` として数えられ、二重に記録されることはありません。そのため、ネットワーク障害後の再試行で二重計上されることはありません。 * `rejected` - 購入が検証に失敗しました。`reason` がどのルールに違反したかを示します。 セッションが存在しない場合や無効化されている場合は、バッチ全体が拒否されます。

週次アクティビティダイジェストのテストメールを送信する POST

対象セッションについて、直近7日間の実際のアクティビティデータを使って、連携済みの成人に週次ダイジェストメールを1通生成して送信します。連携作業中にダイジェストをプレビューするための機能です。テストモードでのみ利用でき、ライブモードでの呼び出しは `400` `INVALID_INPUT` エラーで拒否されます。