Salesforce B2C Commerce Hooks FAQs

Question 1

Where do I register my hooks in a Salesforce B2C cartridge?

Accepted Answer

Hooks are registered in a hooks.json file, which must be referenced in the 'hooks' property of your cartridge's package.json file to be recognized by the commerce server.

Question 2

How do I prevent my hook from skipping system calculations?

Accepted Answer

To ensure system implementations run, your hook script should return undefined or nothing. Returning a Status object in OCAPI/SCAPI hooks specifically skips subsequent hooks and system logic.

Question 3

What happens if a hook encounters an error?

Accepted Answer

Returning Status.ERROR will stop processing and rollback the current transaction. Be aware that repeated failures may trigger a circuit breaker, resulting in an HTTP 503 error for that extension point.

Question 4

Can I pass data between different hooks in the same request?

Accepted Answer

Yes, you can use the request.custom object to store and retrieve data across multiple hooks (such as passing data from an afterPOST hook to a modifyResponse hook) within the same request lifecycle.

Question 5

What is the difference between OCAPI and SCAPI hooks?

Accepted Answer

Both APIs share the same hooks and extension points; you can distinguish between them using the request.isSCAPI() method within your script implementation to apply API-specific logic.

Salesforce B2C Commerce Hooks

Salesforce B2C Commerce Hooks

Key Features

Use Cases

Key Features

Use Cases