Method: partners.subscriptions.provision
Stay organized with collections
Save and categorize content based on your preferences.
Used by partners to provision a subscription for their customers. This creates a subscription without associating it with the end user account. subscriptions.entitle must be called separately using OAuth in order for the end user account to be associated with the subscription. It should be called directly by the partner using service accounts.
HTTP request
POST https://paymentsresellersubscription.googleapis.com/v1/{parent=partners/*}/subscriptions:provision
The URL uses gRPC Transcoding syntax.
Path parameters
| Parameters |
parent |
string
Required. The parent resource name, which is the identifier of the partner. It will have the format of "partners/{partner_id}".
|
Query parameters
| Parameters |
subscriptionId |
string
Required. Identifies the subscription resource on the Partner side. The value is restricted to 63 ASCII characters at the maximum. If a subscription was previously created with the same subscriptionId, we will directly return that one.
|
cycleOptions |
object (CycleOptions)
Optional. The cycle options for the subscription.
|
Request body
The request body contains an instance of Subscription.
Response body
If successful, the response body contains an instance of Subscription.
Except as otherwise noted, the content of this page is licensed under the Creative Commons Attribution 4.0 License, and code samples are licensed under the Apache 2.0 License. For details, see the Google Developers Site Policies. Java is a registered trademark of Oracle and/or its affiliates.
Last updated 2025-08-13 UTC.
[null,null,["Last updated 2025-08-13 UTC."],[[["\u003cp\u003eUsed by partners to create subscriptions for their customers without initial end-user association, requiring a separate \u003ccode\u003esubscriptions.entitle\u003c/code\u003e call for user linking.\u003c/p\u003e\n"],["\u003cp\u003eThe API endpoint for provisioning is \u003ccode\u003ePOST https://paymentsresellersubscription.googleapis.com/v1/{parent=partners/*}/subscriptions:provision\u003c/code\u003e and should be accessed directly by partners using service accounts.\u003c/p\u003e\n"],["\u003cp\u003eThe request requires the partner ID as a path parameter and a unique subscription ID as a query parameter.\u003c/p\u003e\n"],["\u003cp\u003eBoth request and response bodies utilize the \u003ccode\u003eSubscription\u003c/code\u003e object, detailed in the provided link, for data transfer.\u003c/p\u003e\n"]]],["Partners use a POST request to `https://paymentsresellersubscription.googleapis.com/v1/{parent=partners/*}/subscriptions:provision` to provision customer subscriptions. The `parent` path parameter identifies the partner, and the `subscriptionId` query parameter uniquely identifies the subscription. The request body and response body both utilize the Subscription resource. This action creates a subscription without user association, which is handled separately via subscriptions.entitle. The service account handles this action on behalf of the partner.\n"],null,["# Method: partners.subscriptions.provision\n\n- [HTTP request](#body.HTTP_TEMPLATE)\n- [Path parameters](#body.PATH_PARAMETERS)\n- [Query parameters](#body.QUERY_PARAMETERS)\n- [Request body](#body.request_body)\n- [Response body](#body.response_body)\n\nUsed by partners to provision a subscription for their customers. This creates a subscription without associating it with the end user account. subscriptions.entitle must be called separately using OAuth in order for the end user account to be associated with the subscription. It should be called directly by the partner using service accounts.\n\n### HTTP request\n\n`POST https://paymentsresellersubscription.googleapis.com/v1/{parent=partners/*}/subscriptions:provision`\n\nThe URL uses [gRPC Transcoding](https://google.aip.dev/127) syntax.\n\n### Path parameters\n\n| Parameters ||\n|----------|------------------------------------------------------------------------------------------------------------------------------------------|\n| `parent` | `string` Required. The parent resource name, which is the identifier of the partner. It will have the format of \"partners/{partner_id}\". |\n\n### Query parameters\n\n| Parameters ||\n|------------------|------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------|\n| `subscriptionId` | `string` Required. Identifies the subscription resource on the Partner side. The value is restricted to 63 ASCII characters at the maximum. If a subscription was previously created with the same subscriptionId, we will directly return that one. |\n| `cycleOptions` | `object (`[CycleOptions](/payments/reseller/subscription/reference/rest/v1/CycleOptions)`)` Optional. The cycle options for the subscription. |\n\n### Request body\n\nThe request body contains an instance of [Subscription](/payments/reseller/subscription/reference/rest/v1/partners.subscriptions#Subscription).\n\n### Response body\n\nIf successful, the response body contains an instance of [Subscription](/payments/reseller/subscription/reference/rest/v1/partners.subscriptions#Subscription)."]]