How to setup Stripe

Stripe Merchant Credentials setup

  1. Log in to Stripe
  2. Click on API, then on the API Tab.
  3. There is a Publishable Key that is visible and a Secret key that is not. Click the Reveal live key token tab.
    Copy these as they will need to be pasted into the Merchant Facility.

In Salesforce, return to the Merchant Facility.
To locate the Merchant Facility:

  • In Classic, click on the "+" at the end of tabs.  Click into the Merchant Facility.  Press GO button and edit.
  • In Lightning, click on the nine dots (top left).  Click into the Merchant Facility.  Select All from the filter option.  Click into and edit.


  1. Select Stripe in the Payment Gateway field (1). If it is not available, it will needed to be added - See upgrade notes 6.1/6.2 if it has not been updated.  Copy the Publishable Key into the UserID field. Copy the Secret Key into the Payment Gateway Password field.
  2. Enter the Publisher Key (copied above) into the Payment Gateway UserId field (2)
  3. Enter the Secret Key (copied above) into the Payment Gateway Password Field (3)
  4. Change the Default payment Form to Modern.
  5. Click into Payment Gateway Metadata and select any field that are required.

Stripe Webhook Setup

Webhooks provide the ability to further ensure the transactions status is correctly stored in Salesforce.  They are also used to update Metadata elements to enable reporting in Stripe.

1.  Login to Salesforce and click Merchant Facilities from the top menu

2. Select the Merchant Facility and scroll down to the Payment Forms

3. Click the primary Payment Form name from the related list (Do not click edit next to the name).

4. Scroll to Orders/Supplies group and copy the link from the Stripe Webhook field.

Note: If the field does not appear on the Payment Form, edit layout and add the Stripe Webhook field.

You only need to associate the Stripe webhook with ONE Payment Form.  This must be a Payment Form linked to your live/production Merchant Facility and ideally the primary Payment Form.  If the primary Payment Form is being used elsewhere for a webhook (eg. Shopify or PayPal Recurring webhooks), then any other Payment Form linked to the live/production merchant facility will work.

5. Log in to Stripe

6. Select the correct account from the top left hand menu

7. Scroll down the menu on the left, and click API. Then click the Webhook tab in the middle.

8. Click Add Endpoint

Paste the Stripe Webhook link (1) from Salesforce in Step 4.

Select  Select types to send (2) - and select the type you require.

Select the following (3):

  1. charge.captured
  2. charge.failed
  3. charge.pending
  4. charge.refunded
  5. charge.succeeded

Click Add Endpoint button to save.

Do NOT select charged.updated.  This can caused an endless Webhook update loop.

Stripe is now available as a payment gateway option for Payments 2 Us. Follow these steps  for setting up Salesforce Webhook in Stripe and adding the Stripe credentials in Salesforce.

Secret Key Setup

1. Click into the webhook added

2. Click "Reveal" for Secret Signing

3. Copy Secret

4. Paste key into Webhook Secret Key

In Salesforce, navigate back to the Payment Form in Step 4 in the Stripe Webhook Setup section of this guide.