Subscriber management and self-service
Overview
Customer (subscriber) accounts centralize billing, subscription, and transaction data from the 2Checkout system. A single customer (subscriber) can own and use one or multiple subscriptions.
Requirements
Customer accounts/IDs can be associated exclusively with subscriptions generated by the 2Checkout system for products configured using the Merchant Control Panel. To define identifiers yourself, or to have IDs generated automatically, your customers need to use at least one subscription generated for a product with the renewal system enabled.
Subscription status can be active, past due (in the grace period), expired, or canceled.
Customer accounts are not supported for products with the renewal system disabled (without any subscriptions).
Subscription renewals
Subscription renewals will automatically be associated with the same customer using the initial subscription. A new Customer account will not be generated for this scenario since the existing subscriber IDs are used.
Subscription renewal with a new product version
When the subscription for an older product being deprecated is renewed with the subscription of a newer product, it will automatically be associated with the same customer using the initial subscription. A new customer account will not be generated for this scenario since the existing customer IDs are used.
Upgrades
When the subscription for an older product is upgraded with the subscription of a newer product, it will automatically be associated with the same customer using the initial subscription. A new customer account will not be generated for this scenario since the existing customer IDs are used.
Customer scenarios |
||
---|---|---|
|
Existing Customer account is used |
New Customer account is generated |
New purchase |
NO |
YES |
New purchase with new customer ID in the buy link |
NO |
YES |
New purchase with existing customer ID in the buy link |
YES |
NO |
Subscription renewal |
YES |
NO |
Subscription renewal with the new product version |
YES |
NO |
Upgrade creates a new subscription (disables the existing one) |
YES |
NO |
Upgrade prolongs the subscription from the upgrade purchase date |
YES |
NO |
The upgrade does not affect the original subscription duration |
YES |
NO |
What's next
The What's next area is designed to provide an overview of upcoming automatic actions that the 2Checkout system will perform for the subscriptions under a Customer account. It's designed to offer:
- Next billing dates and amounts for subscriptions;
- Next renewal notification dates.
Customer insight
This area reveals the date when the customer account was created.
Total customer value represents the total amount paid by a specific customer (converted to your default payout currency) for all subscriptions purchased for you as long as the orders that served to acquire them (including refunds) were finalized. Only revenue from Finalized orders is taken into consideration.
Orders with the same email address generate independent customers unless you specify the customer in the buy link.
Orders that do not generate subscriptions are not included in any customer value.
The all-time discount represents the total value of discounts offered to a specific customer. Again, only revenue from Finalized orders is taken into consideration.
The Customer insight area also provides details on all the subscriptions purchased by a customer along with information on their evolution in terms of renewals and upgrades. Note: The Upgrades section is displayed only if at least one of the products to which the subscriptions listed under a customer are associated has an upgrade configured.
Currency
The currency featured in the Customer insight area is the same as the default settlement currency for your account. In scenarios in which a customer purchased products from you in another supported currency, its value is converted into the default settlement currency.
Network Cross-selling
The Customer ID used in the buy link is limited to the customers of the vendor which owns the shopping cart. Subscriptions from third-party 2Checkout vendors will not be associated with the same customer ID as that of the main vendor.
Similarly, if your products are sold through network cross-selling by third-party 2Checkout vendors, Customer IDs will be generated automatically by the system and will not be the same as the one set by the main vendor.
Customer Account Status
- Active - a Customer Account is created when the first subscription for a product purchased by a customer becomes active. As long as at least one subscription associated with a customer remains active the Customer Account will also feature the Active status.
- Trial - the Trial status is displayed for those Customer Accounts associated with customers using an active trial subscription.
- Inactive - displayed when all subscriptions of a Customer Account are expired or canceled, or both.
Customer Accounts status |
||
---|---|---|
Subscription status |
Customer account status |
Description |
At least 1 Active subscription |
Active |
Customer account status is Active even if Trial and Canceled/Expired subscriptions exist for the customer, as long as there's at least one Active subscription. Customers with a single subscription featuring the Past due status (expired but in the grace period) are considered Active. |
At least 1 Active Trial subscription |
Trial |
Customer account status is Trial if all Active subscriptions for this customer are trials, regardless of any Canceled/Expired subscriptions. |
Only Expired/Canceled subscriptions |
Inactive |
All subscriptions associated with this Customer account are canceled, expired, or both. |
Edit Customer Details
Click Edit at the bottom of the Customer billing details area to update the information associated with a specific account.
Select the checkbox next to the Update all customer subscriptions end-user details with these details option to also update the customer billing and end-user (delivery) details for all subscriptions governed by the same customer account.
Customer Search
The dedicated Customer area of the Control Panel offers advanced search functionality designed to enable you to find particular or multiple customers. The underlying search technology has been optimized to deliver high performance and efficiency under an intuitive and easy to use interface.
You can only search for customers that have at least one subscription attached. Customers that were created via API (that are not tied to a subscription) cannot be found via the Merchant Control Panel Customers search.
Searches can be performed for:
- 2Checkout customer IDs;
- External customer IDs;
- Customer name/company;
- Customer email address;
- Order reference;
- External reference / PO;
- 2Checkout Subscription Reference;
- Activation key;
- Partner invoice no.;
- SKU.
The search technology used supports partial queries for Customer name/company; email address; 2Checkout Subscription Reference; partner invoice no.; SKY and Activation key. However, when using 2Checkout customer IDs, external customer IDs, order reference, and external reference number the query term must match exactly the data searched.
You can filter results returned by the Customer search based on:
- Customer status;
- Geographic regions;
- Customer country (the same country as specified in the billing details);
- The product(s) purchased by customers;
- The date when the customer was created in the 2Checkout platform;
- The date when a product was upgraded;
- The dates when notifications were sent to customers;
Export customer data
Customer data can be exported using the built-in functionality available alongside the search capabilities of the Merchant Control Panel.
Both customer details and subscription data are included in the CSV (comma-separated values) files that you can export. Essentially, information on single or multiple subscriptions acquired by the same customer is included in the CSV file.
For example, the exported CSV for the customer in the example below will feature two lines, one for each subscription purchased.
Optionally, you can also include the renewal price for customer licenses.
Workflow
Follow the steps below to generate a customer export file.
- Log in to the 2Checkout Control Panel.
- Go to Orders & customers -> Customers.
- Use the existing filters to search for the customer you want to export data for.
- Click Export as CSV.
- Choose whether or not to include the renewal price for customer licenses.
- Click Export.
Export fields
The table below shows the fields included in customer exports.
Field name | Description |
---|---|
AvangateCustomerReference | System generated customer reference number in the 2Checkout system |
ExternalCustomerReference | External customer reference that you control |
CustomerFirstName | Billing first name |
CustomerLastName | Billing last name |
CustomerEmail | Billing email address |
CustomerPhone | Customer phone number |
CustomerFax | Customer fax number |
CustomerAddress1 | Customer address field |
CustomerAddress2 | Customer address field |
CustomerCity | Customer city |
CustomerZip | Customer zip code |
CustomerState | Customer state |
CustomerCountry | Customer country |
CustomerCompany | Customer company name |
LicenseUniqueId | Subscription ID that you control |
IdProduct | Unique system generated product ID |
PurchaseDate | Subscription purchase date |
ExpirationDate | Subscription expiration date |
ProductName | Product name |
Quantity | Purchased quantity |
FirstName | Delivery first name |
LastName | Delivery last name |
Delivery email address | |
CommunicationLanguage | Language selected in the shopping cart upon purchase |
ProductVersion | Purchased product version |
ProductExtra | |
Company | Business customer company name |
Phone | Business customer phone number |
Fax | Business customer fax number |
Address1 | Delivery address field |
Address2 | Delivery address field |
Zip | Delivery zip code |
City | Delivery city |
State | Delivery state |
CountryCode | ISO country code |
ProductOptions | Product pricing options |
ActivationCode | Subscription activation code |
IdPartner | Partner ID (if the order was placed by a reseller) |
LicenseCode | Unique system generated subscription code |
Refno | Order reference number |
RenewalType |
Subscription renewal type:
|
Status |
Subscription status:
|
URL | Merchant homepage URL |
NextRenewalPrice | Renewal price for the next billing cycle |
NextRenewalPriceCurrency | Currency of the next renewal price |
TimeZone | Your account time zone |
ShopperReferenceNumber | Shopper reference number for orders placed by resellers. Can be used in searches for customers, subscriptions and orders. |
AdditionalInfo | Extra information that you can attach to a subscription, such as the source of the initial purchase. |
PastDueDay(s) | Number of days passed since the subscription reached Past Due status |
TestSubscription |
Indicates test orders:
|
SubscriptionStartDate | Subscription generation start date |
IdAffiliate |
Unique affiliate identifier from the 2Checkout platform. Possible values:
|
CustomerValue | High level guideline for the overall business value of a customer. Calculated based on the completed orders placed by the customer. Test orders are not considered. |
CustomerValueCurrency | Currency of the customer value. |
Time zone support
Customer search supports time zone selection, enabling you to choose either the default 2Checkout time zone (GMT + 02:00) or a custom time zone that you control via Account settings / Edit system settings.
The time zone selected in the Customer search area controls the timestamps in which data on specific customer details pages is reported.
Maximum number of results
Customer search displays a maximum of 1,000 results.
When exporting, a maximum of 100,000 items can be included in a single CSV (comma separated values) file. If you'd like more results beyond the first 100,000 to be exported, simply modify date settings to export results in batches of 100,000.
Aggregate Customer Subscription
Use the subscription import functionality to aggregate multiple, disparate subscriptions under a single Customer.
In scenarios in which different orders from the same shopper generate multiple Customer accounts, each with its own ExternalCustomerId, you have the option of moving all subscriptions under the same customer. This can happen when you don't provide the same ExternalCustomerId for orders placed by the same shopper, for example, and the 2Checkout system needs to generate the customer identifier automatically.
When using the import process to move subscriptions from under a customer account to another, the mandatory LicenseUniqueId field needs to be left empty if the subscription in question doesn't feature such an identifier. If you provide an identifier, the 2Checkout system will detect the item you're importing as a new subscription and add it to the targeted customer account, while leaving the subscription you intended to move, but which did not feature a LicenseUniqueId, under its existing customer account. When LicenseUniqueId is left empty, add a new field labeled LicenseCode to the CSV file, and enter the corresponding Subscription Reference identifier. The LicenseCode field can be added at the end of the mandatory fields, just after ExternalCustomerId for example. The presence of the LicenseCode field along with the Subscription Reference value will help the 2Checkout system identify the subscription you want to move from one customer account to another.
To aggregate subscriptions from multiple Customer accounts of the same shopper, you need to edit customer data saved in the 2Checkout system. When importing data for multiple subscriptions already in the 2Checkout system, specify the same ExternalCustomerId in the columns of the CSV file.
Imported subscriptions for which the ExternalCustomerId of an existing customer was provided will automatically be moved under the same account.
Subscription aggregation scenarios
Move a single subscription from Customer A to Customer B.
Customer A features multiple subscriptions. Customer B must have an External Customer ID.
- Create a CSV file and import Subscription A belonging to Customer A but specify the External Customer ID of Customer B in the document.
- The 2Checkout system moves Subscription A from Customer A to Customer B. Customer A continues to be available.
Move multiple subscriptions from Customer A to Customer B.
Customer B must have an External Customer ID.
- Create a CSV file and import Subscription A, Subscription A1, and Subscription A belonging to Customer A but specify the External Customer ID of Customer B for all imported items in the document.
- The 2Checkout system will move Subscription A from Customer A to Customer B. Customer A will continue to be available, as long as it still features at least one subscription.
Move all subscriptions from Customer A to Customer B.
Customer B must have an External Customer ID.
- Create a CSV file and import all subscriptions belonging to Customer A but specify the External Customer ID of Customer B for all imported items in the document.
- The 2Checkout system will move all subscriptions from Customer A to Customer B. Customer A will no longer be accessible since it features no subscription, however, the account will be preserved in the 2Checkout system. As long as you know the External Customer ID of Customer A you will still be able to allow shoppers to place orders using this identifier in the Buy Links or to move subscriptions from different accounts under that of Customer A.
FAQ
What happens to subscriptions generated by the 2Checkout system before the new Customer Account functionality was available?
Individual Customer Accounts, each with its own unique numerical ID, will be created automatically for all subscriptions generated by the 2Checkout system. This is also valid for subscriptions imported in the 2Checkout system prior to the moment when this functionality went live.
Can the 2Checkout Customer ID be changed/deleted?
No. The unique 2Checkout Customer ID is locked and cannot be deleted or modified in any way.