This article applies to Contextual Commerce. (Looking for Classic Commerce documentation?)
FastSpring provides your customers with an easy-to-access website that lets them view their complete order history for your account and manage their subscriptions and payment methods (if applicable).
Account Management Site Examples
Order receipt email messages sent to customers include a link to the customer's Account Management site for your account, as shown in this illustration.
Upon clicking the link, customers see a page that is branded to match your default Web Storefront, on which they are prompted to enter their email address.
The Account Management site includes separate tabs for Orders, Subscriptions, and Account Details and Payment Methods. The Orders tab is displayed by default, so upon logging on, customers will immediately see their order history for your account.
Customers' order items, amounts paid, license keys, download links, and order references / order IDs are all displayed for each individual order.
Gift purchase note
The Subscriptions tab lists all of the customer's active and inactive subscriptions, and the Manage command for each subscription lets the customer update the payment method or cancel the subscription. Customers with manual subscriptions can also click Pay Now on a manual subscription to initiate a payment via a secure, streamlined checkout process.
On the Account Details and Payment Methods tab, customers can view their account information and add or remove payment methods.
Controlling the Appearance of the Account Management Site
The Manage Your Orders link in customers' receipt email messages (sent via the New Email System) always targets the Account Management site via your default Web Storefront. To identify which of your Web Storefronts is the default, select the Storefronts menu in the Dashboard. The Web Storefronts tab will be selected by default. Look for the Default indicator in the list of Web Storefronts.
If you need to change the appearance of the Account Management site, consider using the SETTINGS command for your default Web Storefront. Keep in mind that changes made here will also affect the Storefront itself - not just the Account Management site.
All Stores have a default Web Storefront. FastSpring Support can change which Storefront is the default, but you can cannot delete the default Web Storefront. In case you want the styling of the Account Management site to be different to your Storefronts used for purchases, consider using the default Web Storefront only for the Account Management site, and only provide new / purchasing customers with links to your other Storefronts.
Linking to the Account Management Site
The Manage Your Orders link in customers' receipt email messages (sent via the New Email System) always targets the Account Management site via your default Web Storefront. The format of the link is as follows:
<Secure Web Storefront URL>/account/
You can place a link to the Account Management site on the support pages of your web site and include it in email messages. The link is also provided in all customer-facing email messages.
Account Management Security
In order to log on to the Account Management site - where they can access order history, subscription management, and payment method management tools - customers must verify that they have access to the email address associated with the order. They do this by entering that email address on the initial page of the site, which will result in a message containing a live login link being sent to that address. Customers must then click that temporary link to log in. Thus, anyone who does not have access to that email account would not be able to log in to the Account Management site. Login links contained in these email messages are valid for twenty-four hours, just as with pre-authenticated login links that can be generated via the /accounts endpoint of the FastSpring API (see below).
Providing Customers with Pre-Authenticated Account Management Links
If you take advantage of the FastSpring API and you have your own external customer account functionality, you can optionally provide pre-authenticated Account Management links to customers who are logged on to your system, so that they do not have to log on a second time on the Account Management site. This is accomplished via the /accounts endpoint, as shown in the example here.
URLs retrieved by this method are valid for twenty-four hours. A customer who clicks a link targeting such a URL - within twenty-four hours - will be taken directly to the Orders tab of Account Management, skipping over the log on prompt.