구매에 대한 부모 승인 요청

POST /transaction/request-purchase

플레이어의 신뢰할 수 있는 성인에게 구매 한 건을 승인하도록 요청합니다. 청구 전에 이 엔드포인트를 사용하고, 승인이 도착한 뒤에만 구매를 완료하세요. 요청은 expiresAt까지 보관되며, 그 이후에는 더 이상 승인하거나 거부할 수 없습니다.

결과는 approved, denied 또는 expired를 담은 Transaction.PurchaseApprovalResult Webhook으로 전달됩니다. Webhook을 무기한 기다리기보다 expiresAt를 마감 기한으로 취급하세요.

이미 결정을 기다리고 있는 id를 다시 제출해도 안전한 무작업입니다. 대기 중인 요청이 그대로 반환되고 두 번째 요청이 생성되지 않으므로, 네트워크 장애 후의 재시도로 두 번 요청하지 않습니다.

플레이어는 결정을 기다리는 구매를 최대 20건까지 보유할 수 있습니다. 그 이상이면 하나가 해결될 때까지 호출이 INVALID_INPUT으로 거부됩니다.

Request

승인 요청이 수락되었습니다.

잘못된 요청입니다. 응답 본문의 error 필드에 구체적인 코드 (INVALID_INPUT, NOT_FOUND, FEATURE_DISABLED 등)가 담깁니다.