# Acquisition Flow

## Buy a new Subscription: Limio for Salesforce Acquisition Journey Flow

The Limio for Salesforce Managed Package comes with an out of the box pre-built Salesforce Flow that allows to create a new subscription for a customer, in the context of a Person Account, Contact, or Case record.

When Limio for Salesforce is installed, the flow is created in the org as "Limio Acquisition Journey", and can be found in the list of flows.<br>

<figure><img src="/files/9WSiXaNoFMqtgi0q4Rq7" alt=""><figcaption></figcaption></figure>

Because this flow is a template one, it can be copied and customised to accommodate for customer specific requirements, that are not necessarily part of the master flow.

This document provides an overview of the master flow, what its component are for, and where to add customisations, if required.

## Flow Overview

Overall, the acquisition journey consists of the following steps:

* search for the relevant offer from the Limio offer catalog
* customise the relevant information such as quantity
* specify a payment method
* submit the order<br>

  <figure><img src="/files/QQ9mxCJNnxqcfYS5cTwv" alt=""><figcaption></figcaption></figure>

### Pre-requisite: Pass the recordId

The flow is designed to work in the context of a Salesforce a Person Account, Contact, or Case record. As such, the input variable recordId must be populated with a respective Salesforce record Id at the beginning of the flow.

### Step: Default Customer Country

The default customer country is retrieved in the flow from Limio via the apex class "Get Purchase Country". This is the purchase country associated to the customer record in Limio.

The default country being used can be changed, see the relevant article [Capture an Additional Payment](/integrations/using-limio-for-salesforce/payment-method-options/capture-additional-payment.md)

### Step: Offer Selection

The offer selection is implemented with the custom lightning component Limio Offer Catalog<br>

<figure><img src="/files/J9LmpWjQl1zgLETxUewM" alt=""><figcaption></figcaption></figure>

This component loads the offers catalog from Limio. The default country the catalog is initiated with is the one retrieved in the previous step.

In order to move on to the next step the user must select an offer, simply by clicking a row in the table.<br>

<figure><img src="/files/nILggiSOtmTbojpJSk9j" alt=""><figcaption></figcaption></figure>

### Step: Order Data

For an acquisition journey, the user can customise the start date and quantity for the selected offer.. Currently, editing start date is not supported, and it's always defaulted to the current's date, and made read only. As for quantity, this is made editable only if the selected Limio offer has the Allow Multibuy property set to true. If not, the quantity will be read only and set to 1 by default.<br>

<figure><img src="/files/3mU0hX98K6u457WnmP2g" alt=""><figcaption></figcaption></figure>

### Optional Step: Delivery Address

If the selected offer includes a physical product (e.g. magazine) that requires a delivery address, the delivery address component is shown on the next step.<br>

<figure><img src="/files/hrEAkBFYo3Mt1783USG3" alt=""><figcaption></figcaption></figure>

The Address Book is retrieved from Limio by the apex class "Get Customer Address", and it returns the list of all addresses from the customer record in Limio.

This list can be customised, see the relevant article [Capture an Additional Payment](/integrations/using-limio-for-salesforce/payment-method-options/capture-additional-payment.md)

### Step: Payment Selection

This steps shows the supported payment methods configured within the flow.<br>

<figure><img src="/files/y47VcFEE0NDGwpGAATCH" alt=""><figcaption></figcaption></figure>

Since this uses the standard picklist flow component, payment methods can be configured directly within this component, as picklist choices.<br>

<figure><img src="/files/PyDfbRkbFz3BOU6n1P5J" alt=""><figcaption></figcaption></figure>

Once the relevant payment method is selected, click next to navigate to the dedicated payment capture page.

### Step: Supported Payments

Supported payment options include

* credit card (via Zuora iframe)
* direct debit (via Zuora iframe)
* Stripe Payment Element (via Stripe iFrame) — see [Set Up Stripe Payments for Salesforce](/integrations/setting-up-limio-for-salesforce/detailed-salesforce-setup/stripe-payments-for-salesforce.md)
* checkout link generation (learn more about this feature here: [Checkout Link](/integrations/using-limio-for-salesforce/generate-checkout-link.md))
* invoice (learn more about this feature here: [Invoice as a Payment Method](/integrations/using-limio-for-salesforce/payment-method-options/invoice-payment-method.md))

More payments can be added to the flow, see the dedicated section here: [Capture an Additional Payment](/integrations/using-limio-for-salesforce/payment-method-options/capture-additional-payment.md).

#### Stripe Payment Element

When Stripe is configured as the payment method, the Stripe Payment Element iFrame is rendered directly within the Flow screen. The payment is processed through the Limio Stripe Connect integration — no Zuora HPM setup is required. See [Set Up Stripe Payments for Salesforce](/integrations/setting-up-limio-for-salesforce/detailed-salesforce-setup/stripe-payments-for-salesforce.md) for configuration details.

#### Zuora iframe - Credit Card

<figure><img src="/files/SWZtkivblVOJmLYtmtkt" alt=""><figcaption></figcaption></figure>

The credit card Zuora iframe is loaded with the following information:

* pre filled cardholder name from the contact/person account the case is linked to
* pre filled email from the contact/person account the case is linked to
* countries from the list of allowed countries for the selected offer, as specified in the first step
* address book: list of addresses stored for the customer record in limio, if anything. This list could be customised to also pull additional entries from other salesforce records, see dedicated section in [Capture an Additional Payment](/integrations/using-limio-for-salesforce/payment-method-options/capture-additional-payment.md)

### Step: Order Summary

In the last step a summary of the order is shown, with the selected offer and total to pay. At this point the user only needs to submit the order, and they'll receive immediate feedback about the order submission to limio. This is the last and final step of the flow. The subscription is now created.<br>

<figure><img src="/files/0J0TTsCORpIlDiyxGURL" alt=""><figcaption></figcaption></figure>


---

# Agent Instructions: Querying This Documentation

If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter:

```
GET https://docs.limio.com/integrations/using-limio-for-salesforce/acquisition-flow.md?ask=<question>
```

The question should be specific, self-contained, and written in natural language.
The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.