Subflow: Switch
Introduction
Limio for Salesforce Manage Subscriptions flow (please, find an overview here: ) among others contains a Switch subflow. It allows users to upgrade and downgrade customers' active subscriptions.
Flow Overview
This section will offer a overview of the Salesforce Manage Subscriptions flow’s Switch process. It will provide detailed insights into the Flow Builder representation of the Switch subflow and outline how customization options can enhance your user experience.
Switch Screen: captures details of the switch. Learn about Input: Maximum allowed refund amount property in
Get Switch Order Preview: action responsible for retrieving a Zuora preview of the switch order based on the selected offer, effective date, and current subscription.
Get Customer Address List: retrieves a list of customer addresses for the current customer from Limio.
Is Offer Deliverable Decision: decides whether the newly selected offer is deliverable and if it is, the flow navigates to the Delivery Address Screen.
Payment Selection Screen: allows the user to select a payment method for the order. Hosts a Limio Order Total reusable component which displays a Zuora preview calculation of the order total.
Limio Order Total: Input: Component Position property allows customising alignment of the component on the screen (set to "right" by default).**
**
Select payment is a flow native Picklist component which allows to easily customise the list of available payment methods, learn more in
Selected Payment Decision: based on the selected payment method, navigates to one of the following screens:
Zuora Payment Screen: handles payments within a Zuora iframe - used for credit cards and direct debit.
Customer Wallet Screen: contains a table with previously used payment methods for the current subscription.
Order Summary Screen: displays a summary of the order.
Input: Custom billing address fields, Input: Custom delivery address fields allow passing custom details to the respective address objects in the order payload, learn more in
Screenshot at Dec 27 17-18-32.png
Agent's View
This section offers a step-by-step guide for agents navigating the Limio for Salesforce Manage Subscriptions flow. It walks through the main screen components from the agent perspective.
Select a Subscription: this and the next one are the two common screens at the beginning of a Manage Subscriptions parent flow. - Table columns can be customisable, see - To manually sync data from Zuora to LFS, see
Select an Action:
Select "Switch". After clicking Next, flow navigates to the Switch subflow.
Note: The Switch action is available to all non-gift active subscriptions. Learn more about allowed actions and how to override and customise them in
3. Enter Switch details
Select New Offer:
Note: learn how to pre-load filters based on the specific journey and subscription criteria in
After the offer was selected, Zuora preview API returns a calculated order total for the selected offer and effective date and displays it in a table view on top of the screen.
Screenshot at Dec 27 17-23-47.png Exception handling
In case of an inability to calculate the Zuora preview, a warning message is displayed along with the Request Id that can help troubleshoot the root cause of an issue.
Change Effective Date: Billing period is a period between the last and the next schedule dates set by the billing frequency.
Effective date defaults to the End of the current billing period
Effective date must be within the current billing period
Current billing period start and end dates are displayed on the UI
If an effective date selected is outside the limit, an error message is displayed and it blocks further order processing: the date has to be amended in order to proceed to the next step.
Screenshot at Dec 27 15-12-34.png
Maximum allowed refund amount By default, a refund amount, generated as a result of a downgrade, is capped with the latest charge. However, in some business cases you might want to limit it to a smaller number. This can be achieved by setting a limit in the flow property. Learn more in When M_aximum allowed refund amount_ is populated, the component will compare the preview total amount against this limit; if the total amount exceeds such limit a user will see an error message, and they won't be able to proceed to the next screen until the total is below the set limit (by changing an offer or an effective date).
4. Submit an Order
At the top of the last screen, users can find an overview of the order to confirm the purchase with the customer. The field set in the top section is dynamic and depends on the order.
After submitting the order, Submit button becomes disabled and users can see order processing status. In case of an error, events entry will contain an error message.**
**
Tips
When migrating subscriptions from a legacy system, there might be discrepancies in subscription details, especially in dates. We recommend performing a Zuora/Limio sync on all migrated subscription at the end of the migration to ensure data integrity.
Last updated
Was this helpful?