Use the Stripe app for Salesforce Commerce Cloud

This guide explains how to use the Stripe app for Salesforce Commerce Cloud after you install and configure it. You can learn about the day-to-day functionality available to businesses and customers, including payment processing, saved payment methods, and data management.

Merchant roles and responsibilities

After you set up configurations and job schedules, the functionality runs on demand. You don’t need to perform any ongoing maintenance or other tasks.

Business Manager

The cartridge comes with two jobs:

• Stripe - Delete Custom Objects
• Stripe - Process Webhook Notifications

Enable the Stripe - Process Webhook Notifications job for the desired site. Learn more about how to configure the Business Manager.

Storefront functionality

When an authenticated customer selects a saved credit card on the payment page, they can see a list of their Stripe-saved payment sources as radio buttons rather than the default SiteGenesis select options.

After a customer saves their address and credit card information in their browser, they see the payment request button. The customer sees Pay now or an Apple Pay button, depending on what their device and browser combination supports.

Data storage

Use the Stripe LINK cartridge to store additional data in Commerce Cloud. Review the Stripe service level agreement for service uptime commitments.

If the service fails, transactions won’t proceed because there’s no failover, and your users see a clear error message. If you experience problems or have suggestions for improvements, contact support.

The customer profile data includes the Stripe Customer ID for retrieving customer information from your Stripe account:

• stripeCustomerID(string): Store Stripe Customer ID

The custom attributes for the order and basket store the PaymentIntent and review status information:

• stripePaymentIntentID(String): Store PaymentIntent ID
• stripeIsPaymentIntentInReview(Boolean): Store PaymentIntent in review

The custom attributes for the payment transaction store charge details, client secrets, and source information:

• stripeChargeId(string): Store Charge ID
• stripeChargeOutcomeData(text): Store Charge outcome data
• stripeClientSecret(string): Store client secret
• stripeJsonData(text): Store webhook JSON data
• stripeOrderNumber(number): Store order number
• stripeSourceCanCharge(boolean): Store if Stripe Source can be charged
• stripeSourceId(string): Store Stripe Source ID

Additional payment transaction attributes store card details, customer information, and payment preferences:

• stripeChargeId(string): Store Charge ID
• stripeCardID(string): Store card ID
• stripeCustomerID(string): Store Customer ID
• stripeDefaultCard(boolean): Store Stripe default card
• stripeClientSecret(string): Store client secret
• stripePRUsed(boolean): Store payment request button used
• stripeSavePaymentInstrument(boolean): Store save payment instrument
• stripeSourceID(string): Store Stripe Source ID

Custom objects are available in the Business Manager under Merchant Tools > Custom Objects > Custom Objects:

• StripeWebhookNotifications

Failover and recovery process

Your customer can’t check out if the Stripe service is unavailable. You can track the service availability in SFCC using the Service Status.

Upgrade the LINK cartridge

Before you upgrade, we recommend:

• Backing up your files and any other custom dependencies.
• Installing the latest version from the LINK Marketplace in your test environment.
• Testing the front-end UI and back-end data integration.
• Keeping a copy of any customizations you made to the module’s original code.
• Porting over any customizations you made to the module’s code after upgrading and resolving any potential conflicts.