Endpoints交易

为购买请求家长批准

就一笔购买请求玩家的受信成年人予以批准。请在扣款前调用本接口,并且只在批准到达后再完成购买。请求会保留至 `expiresAt`,此后既不能批准也不能拒绝。 结果通过 `Transaction.PurchaseApprovalResult` webhook 送达,其中携带 `approved`、`denied` 或 `expired`。请将 `expiresAt` 视为截止时间,而不要无限期等待 webhook。 重复提交一个已在等待决定的 `id` 是安全的空操作:会原样返回待处理的请求,不会创建第二个请求,因此网络故障后的重试不会重复提示。 每位玩家最多可有 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"}