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
- Ensure the
bm_cybs_sfracartridge is on the Business Manager cartridge path. See Configure the Salesforce B2C Commerce Plugin. - 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.
- 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.
| Group | Product | Event Types | Notification Route |
|---|---|---|---|
| Fraud Management | Decision Manager | risk., risk. | WebhookNotification-dmNotification |
| Fraud Management | Fraud Management Essentials | risk., risk., risk. | WebhookNotification-dmNotification |
| UC Webhook Events | Unified Checkout | uc. | WebhookNotification-paymentNotification |
Subscribe to Webhooks
- Enable the site preferences for the required webhooks: Decision Manager within Salesforce Default Acceptance Configuration and Unified Checkout within Secure Integration Configuration.
- Click Sync. The cartridge subscribes (or updates) each enabled webhook based on the set Custom Site Preferences, and stores the subscription state.
- Confirm each subscription has an
ACTIVEstatus. If the status isPENDING_REVIEW,INACTIVE, orSUSPENDED, the subscription is not yet active. Wait up to 15 minutes and click Sync again. Contact Support if the status does not change toACTIVE.
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
OrderNumbersparameter 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.
Thanks for your feedback!
Last published: November 18, 2026