Stripe Checkout
  • 17 Jul 2024
  • 3 Minutes to read
  • Dark
    Light

Stripe Checkout

  • Dark
    Light

Article summary

Stripe Checkout is a solution prepackaged from Stripe. We've added an integration so users will be able to utilize its functionality right from Salesforce. Click here to read more about Stripe Checkout.

Prerequisites

  1. The Events and Payments packages must be installed and configured in your org.
  2. Stripe Checkout must be used with a Payment Gateway with the Provider set to "Stripe".
  3. To activate Stripe Checkout, please contact Blackthorn Support, who will enable Stripe Checkout on your license metadata.

Configure Event Settings

Add Stripe Checkout to the Event Settings Object

  1. Navigate to Setup.
  2. Use the Object Manager to find the Event Settings object.
  3. Click Fields & Relationships on the Event Settings object.
  4. Search for and select Enabled Payment Methods.
  5. Go to the Values section and click New.
  6. Add "Stripe Checkout" to the text box.
  7. Click Save.

Set the Value on the Event Settings Object

  1. Navigate to the Event Settings object you would like to use for your Stripe Checkout transactions.
  2. Edit the Enabled Payment Method field to include "Stripe Checkout".
    • NOTE: If using Stripe Checkout please do not enable other Payment Methods (except Pay Later)

Configure the Payment Gateway

Update Your Page Layout

  1. Navigate to the Payment Gateway object in Setup.
  2. Click Page Layouts.
  3. Click Payment Gateway Layout.
  4. Add the Accepted Checkout Payment Methods field to the page layout.

Set Values on the Payment Gateway Object

  1. Navigate to the Stripe Payment Gateway that will be used for Stripe Checkout.
  2. Edit the Accepted Checkout Payment Methods field to include the Payment Method to be used for Stripe Checkout. The checkout Payment Method types Stripe Checkout supports are listed here.
    NOTE: Stripe updates this list periodically.
Using currencies other than the US Dollar

Certain Payment Methods like Sepa Debit only work with certain currencies (EUR). Check out this Payment Method fact sheet to review limitations for each Payment Method type.

Add Permissions to Access Encrypted Data

  1. Create a new permission set in Setup.
  2. Name it "Access Encrypted Data".
  3. Navigate to System Permissions.
  4. Click Edit.
  5. Check the View Encrypted Data checkbox.
  6. Save the permission set.
  7. Navigate to the user record in Setup for the person who authenticated the Events app. This is the person who clicked the Authenticate button while running the Events setup wizard.
  8. Add the permission set you just created to that individual's user record.

Setup Webhooks

If you haven't already setup webhooks in your org, you'll want to do this. Stripe Checkout utilizes data that is brought into the org via webhooks. Related records like Payment Method and Payment Gateway Customer are attached to the Transaction after the webhooks process.

Enable SCA

If you are using Strong Customer Authentication (SCA), you must also enable the SCA feature.

To enable SCA in your org, complete the following steps. 

  1. Click the Gear icon.
  2. Click Setup.
  3. In the Quick Find box, enter and click "Custom Settings."
  4. Click Manage next to Blackthorn Pay - Trigger Settings.
  5. Click Edit.
  6. Set Enable SCA = "True" (checked).H_02_22_enable sca in org
  7. Click Save.

Complete a Stripe Checkout with Events

  1. Wait for the Event's record to load.
  2. Register an Attendee.
  3. Click Pay.
  4. Wait for Stripe Checkout to load.
  5. Complete the Stripe Checkout form.
  6. Observe the success page.
  7. Navigate back to the Event's record.
  8. Open the registered Attendee record.
  9. View the Invoice and Transaction records to make sure payment was processed sucessfully.

Stripe Checkout Considerations

Payment Method Type Limitations

If you are not seeing your preferred Payment Method type as an option this is because it is not currently support by Stripe Checkout. A list of supported Payment Method types for checkout can be found here.

  • Example: ACH is NOT supported in Stripe Checkout. Please use one of our other solutions for this Payment Method type. "afterpay clearpay" is also on this list; however, it is not supported.

Apple Pay and Google Pay

In order to see the option for Apple Pay or Google Pay in Stripe Checkout you must be viewing Stripe Checkout from a supported device. Discover more about wallets here.

Example: To view the Apple Pay button in Stripe Checkout you must be using an iOS device AND have your Apple wallet configured.

Supported Payment Methods

  • alipay
  • card
  • ideal
  • fpx
  • bancontact
  • giropay
  • p24
  • eps
  • sofort
  • sepa_debit
  • grabpay
  • acss_debit
  • wechat_pay
  • boleto
  • oxxo

What's Next