Buy-link template for ordering a Service via Storefront

When a customer orders a new Service via Storefront, a buy-link attached to the Buy now (or Try it) button on the Product page (see Product page) is used. A buy-link is generated using a template and includes information required for ordering a Service. By clicking the button, a customer is redirected to the Customer Control Panel for creating a Sales Order.

In this article:

Template

A buy-link for ordering a Service via Storefront is generated using the following template:

https://{base_url}/external_dispatcher/settle?shopping_cart_items[][plan_id]={plan_id}&shopping_cart_items[][plan_period_id]={plan_period_id}&shopping_cart_items[][type]=application&manager_key={manager_key}&shopping_cart_items[][type]=topup&shopping_cart_items[][amount]={topup_amount}&skip_all_steps=1

Attributes in a buy-link are specified via &. Some attributes are optional (see the description and examples below). The attribute &shopping_cart_items[][type]=application does not require modifications and should always be specified as is.

Attributes

Attribute	Required/Optional	Description
base_url	Required	Domain name of the Reseller linked to the Customer Store (see Viewing and updating Reseller domain information)
plan_id	Required	ID of the Plan to which a Subscription is ordered (see Viewing the List of Plans)
plan_period_id	Required	ID of the Plan Period to which a Subscription is ordered (see Updating Plan Periods) In Storefront, on the Product page, the ID of a Plan Period corresponding to a Subscription with the minimal price within the Plan is automatically linked to the Buy now button. The ID of a trial Plan Period is automatically linked to the Try it button (see Product page). A customer can change the Plan Period on the Subscription configuration step in the Customer Control Panel.
manager_key	Optional	The key of a Manager if it is necessary to link the customer's Account to a given Manager. In Storefront, the Manager's key is not displayed in the URLs of its pages. A Manager should manually provide a customer with a link that includes the key. The Manager's key can be added to a link with the URL of any page of Storefront. When a customer orders a new Service via Storefront, it is possible to link the customer's Account to a given Manager. To perform this action, the following conditions should be met: The Manager has the Active status, and the Key is provided in the Manager's information (see Adding a Manager). A customer visited any page of Storefront via a link with the `&manager_key={manager_key}` attribute. The customer's Account is not yet linked to any Manager, or it is a new Account. For information about the linked Manager for an Account, see Viewing and updating an Account's details. Linking the customer's Account to a given Manager has the following specifics: On the customer side, the Manager's key is stored in the browser cookies for one month. During this period, it is usually unnecessary to use the Manager's key in the Storefront links for automatic linking an Account to a Manager: the cookies data will be used. A link that includes the Manager's key should be used if the browser cookies were cleared. After linking an Account to a Manager, the Manager will receive notifications according to the Account created and Account manager changed Notification Events (see Creating an Event Handler).
topup_amount	Optional	The amount of a top-up Payment in the Reseller currency required to start the Service provisioning. The attribute can only be used for ordering a prepaid Subscription with the Pay as you go billing type (see Pay as you go. Charges generation) without any Resource fees. When a customer orders a new Service via Storefront, using a link with the `&shopping_cart_items[][type]=topup&shopping_cart_items[][amount]={topup_amount}` attribute, a Sales Order with 0 amount and a top-up Payment for the given amount will be created and linked to the Subscription. The top-up payment is required to make sure that an ordered Subscription will not be stopped almost right after its activation: A pay-as-you-go Subscription within the Prepay model blocks funds on the Account balance only for the amount of Resources consumed on the Service side. Usually, the first consumption data from the Service side is processed on the platform side one hour after the Subscription activation. The top-up payment is used to cover the Resource consumption.
skip_all_steps=1	Optional	When a customer orders a new Service via Storefront, using a link with the `&skip_all_steps=1` attribute, the Subscription configuration step in the Customer Control Panel is skipped. It is recommended to use this attribute for ordering Subscriptions with the Pay as you go (internal) billing type because they do not have Resources to be changed and use quotas instead. See also Ordering a Subscription with the Pay as you go (internal) billing type.

Examples

A buy-link to order a Subscription from the test.activeplatform.com Reseller to a Plan with the ID = 425 and a Plan Period with the ID = 1840:

https://test.activeplatform.com/external_dispatcher/settle?shopping_cart_items[][plan_id]=425&shopping_cart_items[][plan_period_id]=1840&shopping_cart_items[][type]=application

A buy-link to order a Subscription from the test.activeplatform.com Reseller to a Plan with the ID = 425 and a Plan Period with the ID = 1840, the Manager's key is ivanov22:

https://test.activeplatform.com/external_dispatcher/settle?shopping_cart_items[][plan_id]=425&shopping_cart_items[][plan_period_id]=1840&shopping_cart_items[][type]=application&manager_key=ivanov22

A buy-link to order a prepaid Subscription with the Pay as you go (internal) billing type from the test.activeplatform.com Reseller to a Plan with the ID = 569 and a Plan Period with the ID = 2072, the top-up amount is 1000:

https://test.activeplatform.com/external_dispatcher/settle?shopping_cart_items[][plan_id]=569&shopping_cart_items[][plan_period_id]=2072&shopping_cart_items[][type]=application&shopping_cart_items[][type]=topup&shopping_cart_items[][amount]={1000}&skip_all_steps=1