Skip to main content
Welcome to the preview portal — This is an early release of the new Doc Hub experience, with more content coming soon.
Technology Partner

Webhooks


sends asynchronous webhook notifications to your Salesforce B2C Commerce store for fraud decisions and Unified Checkout event updates. Webhooks are the primary mechanism for keeping orders up to date. The Salesforce jobs remain available as a fallback.

Webhook subscriptions are managed from a Business Manager page provided by the bm_cybs_sfra cartridge.

Prerequisites

  1. Ensure the bm_cybs_sfra cartridge is on the Business Manager cartridge path. See Configure the Salesforce B2C Commerce Plugin.
  2. Go to Administration > Organization > Roles & Permissions, select the role, then go to Business Manager Modules, select the required context, and enable Webhook Manager under Visa Acceptance.
  3. For the Unified Checkout webhook, the Response Message Level Encryption key must be loaded and configured before registering the webhook. See Response MLE.

Webhook Groups and Events

The cartridge manages two webhook groups. Each notification is delivered to a controller route in the storefront cartridge.

GroupProductEvent TypesNotification Route
Fraud ManagementDecision Managerrisk.casemanagement.decision.accept, risk.casemanagement.decision.rejectWebhookNotification-dmNotification
Fraud ManagementFraud Management Essentialsrisk.profile.decision.review, risk.casemanagement.decision.accept, risk.casemanagement.decision.rejectWebhookNotification-dmNotification
UC Webhook EventsUnified Checkoutuc.orders.transactionresultsWebhookNotification-paymentNotification

Subscribe to Webhooks

  1. Enable the site preferences for the required webhooks: Decision Manager within Salesforce Default Acceptance Configuration and Unified Checkout within Secure Integration Configuration.
  2. Click Sync. The cartridge subscribes (or updates) each enabled webhook based on the set Custom Site Preferences, and stores the subscription state.
  3. Confirm each subscription has an ACTIVE status. If the status is PENDING_REVIEW, INACTIVE, or SUSPENDED, the subscription is not yet active. Wait up to 15 minutes and click Sync again. Contact Support if the status does not change to ACTIVE.

Subscription Schema

The webhook subscription state is stored in the organization-scoped custom object VisaAcceptanceWebhookSubscription (keyed by ConfigId), which records the WebhookId, WebhookUrl, SecurityKey, Status, BaseUrl, and EgressPublicKey. The object is managed by the Webhook Manager. You do not need to edit it manually.

Fallback Jobs

If webhook delivery is interrupted, these Salesforce jobs can be used to reconcile the order state:

  • Payment: Decision Manager Order Update: polls for Accept/Reject decisions on unconfirmed orders (fallback for Fraud Management webhooks).
  • Payment: Refresh Payment Status (on-demand job): enter a comma-separated list of order numbers in the OrderNumbers parameter and use Run Now to refresh the Visa Acceptance payment status for those orders.

See Configure the Salesforce B2C Commerce Plugin for the full set of configuration options.

Last published: November 18, 2026