Справочник APIPlatformPlatform billing
(GAP-14) Grant a fresh trial subscription on the target billing account. Thin over `SubscriptionService::grant_trial`. The new subscription is keyed only by `billing_account_id` (no existing subscription id), matching the `@forestvpn/billing` client path `.../{billing_account_id}/grant-trial`.
Эта страница пока доступна только на английском языке. Руководства переведены; автоматически генерируемый справочник API публикуется на английском.
Authorization
bearer_auth AuthorizationBearer <token>
In: header
Path Parameters
billing_account_id*string
Format
uuidHeader Parameters
X-Project-Id*string
UUID of the project that scopes consumer accounts, devices, sessions, and VSpaces for the request.
Format
uuidRequest Body
application/json
TypeScript Definitions
Use the request body type in TypeScript.
(GAP-14) Grant a fresh no-payment trial subscription. Shared by the PLATFORM
(ProjectAuth) and SYSTEM (SuperAdmin) grant-trial handlers. Carries NO
project_id: the PLATFORM actor's project comes from ProjectAuth, and the
SYSTEM (SuperAdmin) actor derives the new subscription's owning project from
the target billing account inside SubscriptionService::grant_trial.
Response Body
application/json
curl -X POST "https://example.com/platform/v1/billing/subscriptions/497f6eca-6276-4993-bfeb-53cbbbba6f08/grant-trial" \ -H "X-Project-Id: 11111111-1111-1111-1111-111111111111" \ -H "Content-Type: application/json" \ -d '{ "days": 0, "plan_id": "00713021-9aea-41da-9a88-87760c08fa72" }'{ "amount_minor": 0, "billing_account_id": "db2251e5-5308-40a7-9f48-3aed5a9ce736", "cancel_at_period_end": true, "canceled_at": "2019-08-24T14:15:22Z", "currency": "string", "current_period_end": "2019-08-24T14:15:22Z", "current_period_start": "2019-08-24T14:15:22Z", "grace_period_end": "2019-08-24T14:15:22Z", "id": "497f6eca-6276-4993-bfeb-53cbbbba6f08", "plan_id": "00713021-9aea-41da-9a88-87760c08fa72", "project_id": "405d8375-3514-403b-8c43-83ae74cfe0e9", "state_reason": "new_purchase", "status": "pending", "trial_end_at": "2019-08-24T14:15:22Z", "vendor_type": "stripe"}