How to refresh Named Credentials

For Limio for Salesforce to work, it needs to be connected to the Limio Subscription Commerce Platform. This is done through Named Credentials, a Salesforce feature which allows you to define the URL of an endpoint callout and the required authentication in a single configuration.

As a default, Named Credentials expire every 30 days. It's very important to refresh frequently your Named Crendentials or the connection between the Limio Checkout for Salesforce and the Limio Subscription Commerce Platform will stop.

Steps to refresh Named Credentials

Go to Setup → Named Credentials → limio, press Edit.

The following values should be populated:

• Name & Label: Limio

• URL: <the URL to your Limio Subscription Commerce Platform> (e.g. https://mydomain.dev.limio.com/)

• Identity Type: Named Principal

• Authentication Protocol: OAuth 2.0

• Authentication Provider: i42_Hub

• Scope: <the link to your Limio Subscription Commerce Platform + /api > (e.g. https://mydomain.dev.limio.com/api)

Make sure the checkbox “Start Authentication Flow on Save" is checked. As soon as you click Save, you will be redirected to the Limio auth page to submit your credentials. This process needs to be done every month to refresh the token.

How do you know that you need to refresh Named Credentials?

You will not see any subscriptions in the Customer Information section, nor any offers in the Offer Catalog. In the console, you will 401 errors when trying to fetch data from the Limio api endpoints.