Stripe Connector for Salesforce Order Management

The Stripe Connector for Salesforce Order Management is a managed package that you install on top of Order Management to enable payment capture and refund for the order servicing supported use cases. It comes with both an asynchronous and synchronous adapter to handle payments and refunds.

Before you begin

1. A storefront hosted on Salesforce B2C Commerce Cloud and Salesforce Order Management on the Salesforce Core Platform.
2. Salesforce Commerce Cloud cartridge for collecting payments with Stripe or Salesforce payments on Commerce Cloud.
3. An integration enabled between SalesforceB2C Commerce Cloud and Salesforce Order Management.
4. Access to CommercePayments API enabled by the PaymentPlatform org permission.
5. Salesforce CommercePayments is only available for orgs with API version 49.0 and later. Commerce Payments is only available in the Lightning Experience.

Core concepts

PaymentIntent

A PaymentIntent is a Stripe term that refers to a transaction created at Stripe to track a payment from creation through the checkout process, which might trigger additional authentication steps. You do this by implementing the Payment Intents API. Locate the payment intent in Salesforce Order Management by locating the Gateway Reference Number (GatewayRefNumber) field against the payment authorisation record for an order summary.

Payment authorisation

A payment authorisation is relevant to both Stripe and the Salesforce OMS. An authorised amount is a sum that a business transmits to a credit or debit card processor to make sure a customer has sufficient funds to complete a purchase – the approved amount of money to be charged.

There are two capture modes in the Stripe LINK cartridge for Salesforce B2C Commerce Cloud – authorise and capture. If the LINK cartridge is set up to authorise a payment during checkout, then Salesforce Order Management creates a payment authorisation record. You can view the payment authorisation against an order summary using this route:

Order Summary Record > Order Payment Summary Record > Payment Authorisations in Related Tab

If you don’t see Refunds in the Related tab, contact your Salesforce administrator and include the payment authorisation related list in the page layout (as shown):

The PaymentIntent ID (pi_XXXXXX) at Stripe is stored in the Gateway Reference Number (GatewayRefNumber) field of the payment authorisation record. The Processing Mode (ProcessingMode) is set as External, which implies that the payment authorisation was processed outside the Salesforce payment platform.

Payment

If the capture mode in the Stripe LINK cartridge is set to Capture, then the payment is captured from the customer. In this case, a payment record is created in Salesforce Order Management. You can view the payment against an order summary using this route:

Order Summary Record > Order Payment Summary Record > Payments in Related Tab

If you don’t see Refunds in the Related tab, contact your Salesforce administrator and include the payments related list in the page layout (as shown):

Balance Transaction ID

The Balance Transaction ID (txn_XXXXXXXXX) against the PaymentIntent (pi_XXXXXX) at Stripe is stored in the Gateway Reference Number (GatewayRefNumber) field. The Processing Mode (ProcessingMode) field value is set as External, which means the payment was processed outside the Salesforce payment platform. In the event the payment was authorised in Salesforce B2C Commerce Cloud Storefront, and the amount was captured in Salesforce OMS later, the payment record is represented as shown:

The Salesforce Payment Gateway ID (SFXXXXX) against the Payment Intent (pi_XXXXXX) at Stripe is stored in the Gateway Reference Number (GatewayRefNumber) field. The Processing Mode (ProcessingMode) field value is set as Salesforce, which implies that the payment was processed by the Salesforce payment platform.

Refund

If a refund is initiated from Salesforce OMS, you can trace it to a Refund record by following this route:

Order Summary Record > Order Payment Summary Record > Refunds (in the Related tab)

If you don’t see Refunds in the Related tab, contact your Salesforce administrator and include the Refunds related list in the page layout (as shown):

The Salesforce Payment Gateway ID (SFXXXXX) is stored in the Gateway Reference Number (GatewayRefNumber) field. The Processing Mode (ProcessingMode) is set as Salesforce, which implies that the refund was processed by the Salesforce payment platform.

Payment gateway logs

You can view logs for the transactions made with the Salesforce Platform by navigating to Order Summary Record > Order Payment Summary Record > Gateway Logs in the Related tab. If you don’t see the gateway logs in the Related tab, contact your Salesforce administrator and include the gateway logs in the related page layout, or execute this SOQL in Developer Console or SOQL Builder in VS Code:

SELECT Id, OrderPaymentSummaryId, ReferencedEntityId, Request, Response, SfRefNumber, SfResultCode, GatewayRefNumber, GatewayAuthCode, GatewayDate, GatewayMessage, GatewayResultCode, GatewayResultCodeDescription, InteractionStatus FROM PaymentGatewayLog