Over-The-Counter Payment Integration

Allow shoppers to place online orders and make payment physically at a convenience store.

The Over-The-Counter (OTC) payment method allows shoppers to place online orders and make payment physically at a convenience store. The ESW cartridge supports this payment option, enhancing flexibility and simplifying the shopping experience.

Key Features

  • Checkout Availability: Shoppers can select Over-The-Counter as a payment method directly on the checkout screen.
  • Custom Order Attribute: A new custom order-level attribute has been introduced:
  • Name: ESW Over the Counter Payments
  • Technical Field: eswOverTheCounterPayloadJson
  • Data Handling: This custom attribute is used to:
  • Store OTC-related payloads
  • Append data received via webhooks and order confirmation
  • Maintain the information in JSON format for processing and tracking

Workflow for Retrieving Over-The-Counter Payment Information in SFCC

Order Confirmation Flow

To enable and retrieve Over-The-Counter (OTC) payment information in SFCC, the following setup and workflow must be in place:

  1. Prerequisites
  • Ensure that the Over-The-Counter Payment Integration feature is enabled in ESW Service Portal (ESP).
  • Add the new event eshopworld.platform.events.oms.orderholdstatusupdatedevent to the endpoint URL subscription in ESW.
  1. Shopper Checkout Experience
  • When OTC payment is enabled for the tenant in SFCC: Shoppers will see Over-The-Counter as a payment method on the checkout payment panel.
  1. Order Placement in SFCC

When a shopper places an order using OTC payment in Salesforce Commerce Cloud Business Manager (SFCC BM):

  • Export Status: Not Exported
  • Confirmation Status: Not Confirmed
  • Payment Status: Not Paid

All the order confirmation related info will be stored in Esw Over the Counter Payload Json (order level custom attribute).

Order Settlement Flow

Once shopper paid for the order the Over-the-counter webhook will publish event to SFCC ProcessWebHooks endpoint. After that order statuses will be updated to following:

  • Export status: Ready for Exported
  • Confirmation status: Confirmed
  • Payment status: Paid
Split Payment Integration
Split payment functionality, enabling shoppers to pay using multiple payment methods
Page Designer Integration
Create dynamic, localized front-end experiences for customers.