Limio Stripe Payments Integration

This feature is currently in beta. As such, it is subject to change and may not have full functionality in its current state. We appreciate your patience and feedback during this phase. Please report any issues or provide feedback to your designated Customer Success Manager.

Limio now supports using Stripe for collecting payments via credit card. The integration is set up to use to vault the payment and uses to store these as Payment Methods in Zuora. This tokenises the card directly in Stripe, and share the token to Zuora.

Please note that this is a different approach from the standard Zuora approach of using a Zuora Hosted Payment Method or Payment Form. You can learn more about it .

Prerequisites

• You will need a Stripe account.

• You will need to activate Credit Card Reference Transaction payment method in Zuora for your Stripe v2 gateway.

Setting it up

1. Stripe Dashboard:

   • Go to

   • In the left-hand menu, click on Developers → API keys to get a secret key

2. Test access:

   • Make sure to switch to “Test Mode” using the toggle on the left in the dashboard.

3. API keys:

   • Stored in Integrations tab under “Stripe”

   • Name doesn’t actually matter it always overwrites it with Stripe at the moment.

4. Zuora configuration:

   • In Zuora, you will need to create a Stripe payment gateway using this .

   • In Limio, go to Developer > Settings at https://<tenant>.limio.com/developer/settings to configure the gateway.

     
   • Publishable Key can be retrieved in the same place as Secret Key above in Stripe

   • Zuora Payment Gateway ID can be retrieved from the Zuora page for the Stripe payment gateway you created in Zuora earlier. It will be visible in the URL bar gatewayId=XXX

     

How it works

Limio Page Builder configuration:

• On the Limio Shop & Self-Service, a Limio Component renders the Stripe Payment Element.

  • The Checkout Form > Payment Manager Field subcomponent will render Stripe for any offers that have Stripe as one of their payment methods.

  • The Self-service Form > Payment Manager Field subcomponent will render Stripe if it is added as an option in a default Field subcomponent, or in the Self-service Form's payment method type prop.

    

Back-End Processing:

When using Stripe’s Payment Element with Limio, the payment flow proceeds as follows:

1. PaymentIntent creation On page load, Limio creates or retrieves a one-time Stripe PaymentIntent via the Limio backend. This intent is tied to the current Limio basket.

2. Rendering the Payment Element Once the PaymentIntent is ready, the Stripe Payment Element (iFrame) is rendered on the Limio Form or Limio Self-Service Form, allowing the customer to enter their payment details securely.

3. Submitting the payment When the customer submits the Limio Order:

   • Stripe collects and confirms the payment details.

   • A Stripe token is generated and passed back to Limio.

4. Zuora Payment Method creation Limio then uses the token to:

   • Create a Stripe Customer (if not already created).

   • Limio creates a corresponding Zuora Payment Method using Stripe’s token (for use in Referenced Transactions).

5. Processing the payment If a payment is required:

   • Limio creates a Credit Card Referenced Payment in Zuora.

   • This payment is linked to the card saved via Stripe’s Payment Element and associated with the Stripe Customer.