Skip to main content
Build the future with Agentforce at TDX in San Francisco or on Salesforce+ on March 5–6. Register now.

Set Up Salesforce Payments

Learning Objectives

After completing this unit, you’ll be able to:

  • Explain the relationship between a payment gateway and a merchant account.
  • Enable Salesforce Payments in your Salesforce org.
  • Describe how to assign users the Salesforce Payments Administrator permission set.

Salesforce Payments Basics

The online payment experience directly impacts the conversion of online transactions. An efficient, user-friendly payment experience is essential to your business success. But with so many payment options available to shoppers, integrating an efficient payment solution with your online checkout flow can be a complicated process.  

Salesforce Payments is a no-code payment app on the Salesforce platform. It’s easy to set up, easy to use, and easy to integrate with other Salesforce platform apps and your Salesforce solution.

Payment Gateway and Merchant Account

Online electronic payment systems require two essential elements: a payment gateway and a merchant account.

Payment Gateway

A payment gateway is a client-side checkout portal where customers enter credit card information or credentials for a payment service. The payment gateway doesn’t process a payment, but captures payment details, and securely passes the payment data to a payment processor linked to your merchant account.

Payment process from payment gateway to receiving payment in your merchant bank.

Merchant Account

Merchant accounts hold funds transferred from the issuing bank (the bank that backs the credit card or payment service). When a customer enters credit card information to a payment gateway, the credit card’s issuing bank confirms that the customer has adequate funds or credit to cover the payment. If approved, the transaction and payment are authorized. Funds for the transaction amount are then transferred from the issuing bank into your merchant account. After funds for the transaction are deposited into your merchant account, they can be routed to your business bank account.

A Streamlined Payments Process

Salesforce Payments partners with Stripe to manage payment processing. Stripe acts as the payment gateway and the merchant account, providing both tokenization and authorization. All that your company needs is a Salesforce Payments merchant account and your business bank account to receive payments.

Salesforce Payments supports most payment methods. The most common payment methods include:

  • Credit and debit cards
  • Direct debit
  • Digital wallets
  • Buy now pay later options

Component Integration

You can easily integrate Salesforce Payments with Salesforce Commerce Cloud and Order Management. The Salesforce Payments component drops right into your checkout page. The component confirms payments, and supports fraud protection using 3D Secure authentication.

Make a Set Up Plan

Ursa Major Solar, a solar power equipment manufacturer, just added Salesforce Payments to their org. Maria Jimenez, the admin at Ursa Major Solar, is ready to get Salesforce Payments up and running.

Maria Jimenez, admin at Ursa Major Solar

Setup is easy, but Maria likes to keep things organized with a setup plan. 

  1. Set up an Experience Cloud site.
  2. Enable Salesforce Payments in an org.
  3. Assign the payments permission set to users.
  4. Assign permissions to B2B Buyers.
  5. Create merchant accounts.

Let’s check in on Maria as she executes her plan and learns how to get started with Salesforce Payments.

Create an Experience Cloud Site

Salesforce Payments uses a data channel to move transaction data between a payment provider and the Salesforce database. An Experience Cloud site conveniently serves as the data channel for Salesforce Payments. 

Maria is ready to set up an Experience Cloud site to serve as the payments data channel. This site isn’t customer-facing: Salesforce Payments uses it to make database connections. 

  1. From Setup, in the Quick Find box, enter Digital Experiences and select Settings.
  2. Select Enable Digital Experiences. Save your changes.
    Info: If you previously set up a Commerce store, Digital Experiences is already activated.
  3. Under Digital Experiences, select All Sites.
  4. For All Sites, click New.
  5. Select Build Your Own (LWR), and click Get Started.
  6. Enter the site name and the URL prefix sfpwebhook, and click Create.
  7. Return to the All Sites page.
  8. Next to the new site, click Workspaces.
  9. Select Administration and under Settings select Preferences.
  10. Select Allow guest users to access public APIs and save your changes.
  11. Return to Settings and activate the site.
  12. Return to the All sites page. For the site, select Builder.
  13. Click Publish.

Enable Salesforce Payments in an Org

Next, Maria activates Salesforce Payment in the Ursa Major Solar org. Here are the steps she completes.

  1. Launch your org.
  2. Access the Setup menu from the gear icon.
  3. From Setup, in the Quick Find box, enter Feature Settings.
  4. Select Payments.
  5. Select Enable Payments.
Note

After you enable Salesforce Payments there’s no option to disable payments. Salesforce Payments is an application added to your org just like Salesforce Commerce is added to your org.

Salesforce Payments Permission Sets

Salesforce Payments includes permissions you assign to users who need access to the payments features. Salesforce Payments has two out-of-the-box permissions.

  • Payments Administrator: Assigned to internal users, the permission allows the user to take the following actions
    • Access the Salesforce Payments app and data.
    • Configure merchant accounts.
    • Manage saved payment methods.
    • Manage customer-saved payment methods.
    • Gate access to APIs that are available to Salesforce Payments users.
  • Authenticated Payments User: Assigned to a B2C store and B2B buyers. The permission permits B2B buyers and registered B2C shoppers to manage their saved payment methods.

Assign Payments Administrator Permissions

You assign the Payments Administrator permission to your internal users. Some users need all the administrator permission object controls. They’re usually responsible for configuring and maintaining the Salesforce Payments app settings.

Here’s how to assign the Payments Administrator permissions set.

  1. From Setup, in the Quick find box, enter Permission Sets.
  2. Click Payments Administrator.
  3. Select Manage Assignments.
  4. Assign the permission set.

For internal users who don’t need access to all the object controls, you can modify the permission to grant limited functionality to match their jobs to be done

Clone the Permission Set

As Maria sets up the Payments app, she assigns the Payments Administrator permission to Wei Leung, a developer at Ursa Major Solar. Wei only needs access to a handful of Payments Administrator object controls, so Maria clones and modifies the permission set for Wei. 

  1. From Setup, in the Quick find box, enter Permission Sets.
  2. Click Payments Administrator.
  3. Clone the permission profile.
  4. Rename the profile.
  5. Modify the object settings.
  6. Assign the profile to a user.

Assign the Authenticated Payer Permission Set

Maria is ready to assign the Authenticated Payer permission. Ursa Major Solar wants to grant registered B2C store shoppers and B2B buyers permission to manage their saved payment methods.  

Before we see how Maria enables the permission set, let’s go back to when Maria set up and configured the Ursa Major Solar B2C and B2B stores. 

During the B2C store setup, Maria created an external shopper profile for the store. The external shopper profile is unique in that any change made to the profile applies to all registered shoppers that use the store. 

Maria also assigned a shopper permission set group (Shopper_PSG) to the external shopper profile she created. Shopper_PSG is a placeholder for permission sets. Just like the external shopper profile, when you assign a permission set to the Shopper_PSG, the permission set is granted to all registered B2C shoppers. 

Now, using the components she created during Commerce setup, Maria assigns the Authenticated Permission set to the Shopper_PSG.

  1. From Setup, in the Quick Find box, enter Permission Set Groups.
  2. Select Permission Set Groups.
  3. From the list of permissions, select the permission set group that represents your D2C shopper (typically Shopper_PSG).
  4. In the Permission Set section, click Permission Sets in Group.
  5. Check Add Permission Set.
  6. Select Authenticated Payer.
  7. Click Add and Done.

Now when a shopper registers an account, they’re granted the permissions assigned to the Shopper_PSG, which includes the Authenticated Payer permission set. 

To add the permission set to B2B buyer profiles, Maria modifies the Login & Registration settings for the B2B store’s existing self-registration page and assigns the buyers the Authenticated Payer permission set.

Create and Activate a Merchant Account

Next Maria plans to set up the Ursa Major Solar Salesforce Payments merchant account. Before she starts, she gathers the following business information for the account.

  • Business address
  • Bank account routing details
  • Financial statement descriptors
  • Business tax ID

Now, she follows the onboarding wizard.

  1. Launch the Payments app.
  2. Complete the steps in the setup wizard.

As Maria works through the setup wizard she creates a Payments merchant account, and sets up a payment method set. We learn about payment method sets in the next unit.

Before the merchant account can accept payment transactions, Maria verifies the account business information with Stripe. 

Here are the verification steps she follows.

Maria is still in the Payments app and on the Add a Payment Gateway page.

  1. Select Activate Your Merchant Account and click Next.
  2. Click Go to Stripe.
  3. Enter an email, password, and mobile number.
    A verification code text message is sent to the mobile number.
  4. Enter the verification code.
    An emergency backup code is returned.
  5. Enter your business information as requested on each screen.
  6. When you complete the business verification, click Agree & submit.

Next Maria confirms the gateway and account connection.

  1. Click Go to Payments Account.
  2. From the list of accounts, select the new Salesforce Payments account.
  3. To confirm that the status is complete, and the Payment Status is Enabled, select the Related Tab.
  4. Confirm that the payment gateway is Stripe and the status is Complete.

Maria has successfully set up the Ursa Major Solar Salesforce merchant account. She can now use the same merchant account for multiple Ursa Major Solar B2B or B2C stores and create other merchant accounts as needed.

Next Steps

In this unit, you learned how to complete the initial setup for Salesforce Payments. You can now enable Payments, assign and modify permissions, and set up a merchant account. Next, you learn about payment methods, and how to create payment method sets. 

Resources

Compartilhe seu feedback do Trailhead usando a Ajuda do Salesforce.

Queremos saber sobre sua experiência com o Trailhead. Agora você pode acessar o novo formulário de feedback, a qualquer momento, no site Ajuda do Salesforce.

Saiba mais Continue compartilhando feedback