You are here:
Set Up Your Stripe Integration for Subscriber Lifecycle Management
Integrate the Stripe payment gateway to process payments through Subscriber Lifecycle Management.
To set up the Stripe integration with Subscriber Lifecycle Management, follow these instructions:
Create a Stripe Account and Get the Required Keys
To integrate with the Stripe payment gateway, create a Stripe account and get your API keys. Next, create a webhook in your Stripe account and get the webhook signing secret. You'll need to enter these keys in your org to enable your org to access your Stripe account.
- In a browser, go to: https://dashboard.stripe.com/register and complete the steps to create a new account.
- When you have logged in, click Home and then click Get your API keys.
- Click the button to reveal the secret key.
- Copy both keys and have them available for use in the next step.
- Next, under Developers, click Webhooks.
- Click the button to add a webhook endpoint.
- Enter the webhook endpoint URL in the following format: https://<CommunitySubdomain>.force.com/services/apexrest/<vlocity_namespace>/v1/integrationprocedure/VPL360_ListenStripeWebhookV2
- Select the event type payment_intent.succeeded and add the endpoint.
- Copy the signing secret for the endpoint and have it available for use in the next step.
Update the Stripe API Keys and the Webhook Listener Key
To enable access to the Stripe API to allow the Stripe payment gateway to be used in your org, enter the API keys and the webhook listener keys in the appropriate settings in your org.
- Log in to your Salesforce org.
- To go click Setup.
- In Quick Find, enter Named and click Named Credentials.
- Click the drop-down menu and select New Legacy.
- Go to Stripe and click Edit.
- Select Identity Type as Named Principal and Authentication Protocol as Password Authentication.
- Enter stripe as the username and your Stripe secret key (beginning with sk_) as the password.
- Click Save.
- Next, in Quick Find, enter Custom and click Custom Metadata Types.
- Go to VPLExpress and click Manage Records.
- Go to Stripe Public Key and click Edit.
- In Value, enter your Stripe public key.
- Click Save.
- On the VPL Express Custom Metadata page, go to Stripe Webhook Payment Intent Succeeded and click Edit.
- In Value, enter your webhook signing secret.
- Click Save.
Enable the Payment Method Trigger
To enable the payment method to be updated by the Stripe payment gateway, ensure that the Payment Method trigger exists and is enabled.
- In Quick Find, enter Custom and click Custom Settings.
- Go to Trigger Setup and click Manage.
-
On the Trigger Setup page, go to
PaymentMethodTriggerHandler.DT and click
Edit.
If you don't see this trigger listed on this page, click New to create the trigger.
- If you're creating the trigger, enter the name PaymentMethodTriggerHandler.DT. If you're updating the trigger, leave the name unchanged.
- Select Trigger On.
- Click Save.
Enable Site Users to Access the Stripe Payment Integration Visualforce Page
Integration with the Stripe payment gateway is implemented through a Visualforce page. To enable site guest users to use the Stripe payment gateway, enable the Subscriber360 user profile access to the Stripe payment integration Visualforce page.
- In Quick Find, enter All Sites, and click All Sites.
- Click Builder.
- On the Builder page, click Settings.
- On the General tab, under Guest User Profile, click Subscriber360 Profile.
- On the profile details page, click Enabled Visualforce Page Access.
- Click Edit.
- From the Available Visualforce Pages list, select vlocity_cmt.vplS360StripPaymentIntegration and click the Add arrow to move it to the Enabled Visualforce Pages list if not already added.
- Click Save.
Provide Access to the Order Payment Object and Payment Method Fields
The site user profile and the guest user profile that are assigned to subscribers and anonymous users must be given permission on the required payment-related objects and fields, to enable users to enter or update payment methods and make payments.
- In Quick Find, enter All Sites, and click All Sites.
- Click Builder.
- Click Settings.
- On the General tab, under Guest User Profile, click mediaexpress Profile.
- On the profile details page, click Edit.
- In the Custom Object Permissions section, go to Order Payments and select Read and Create.
- Click Save.
- Next, on the profile details page, go to the Field-Level Security section. Under Custom Field-Level Security, go to Payment Method and click View.
- On the Payment Method Field-Level Security page, click Edit.
- Provide read and edit access to both External Payment Method Identifier and External Payment Customer Identifier.
- Click Save.
-
Go to the Profiles page and click Demo Customer
Community.
Repeat steps to enable read and edit access to the Order Payments object and to provide field-level security access to External Payment Method Identifier and External Payment Customer Identifier for this profile as well.
Update the Trusted Domains in Session Settings
To enable the Stripe payment gateway to access your org, allowlist your org domains in the session settings.
- In Quick Find, enter Session, and click Session Settings.
- Go to the Trusted Domains for Inline Frames section and click Add Domain.
-
Add the following domains:
https://<myDomain>.my.salesforce.com
https://<myDomain>.lightning.force.com.

