Salesforce B2C Commerce Cloud Cartridge

This page covers the Alpha version of the Absolute Labs Commerce Cloud Cartridge, designed to add crypto payments to your B2C Commerce instance. It is subject to change before the connector reaches General Availability.

To enable crypto as a payment method on your Salesforce B2C Commerce Cloud instance, you can leverage the Absolute Labs Cartridge which streamlines the integration with Crypto.com Pay and simplifies the tracking back in Absolute Labs.

The cartridge adds a standard payment method and processor, which covers all states of payments from successful to failed, along with management of refunds of placed orders directly from Business Manager.

Prerequisites

• An HTTPS-enforced SFRA storefront

• The latest int_absolute_crypto cartridge code

• An active Crypto.com merchant account

With Crypto.com, you have a single company account, and one or more sub-accounts called merchant accounts. However, in Salesforce, you can only have one merchant account for each storefront."

1. Add the Cartridge to Your Codebase

• Place the int_absolute_crypto cartridge inside your cartridges/ directory.

your-sfra-project/
├── cartridges/
│   ├── app_storefront_base/
│   ├── app_custom/
│   └── int_absolute_crypto/      <-- 🔹 New cartridge here

2. Update Cartridge Paths and Enable the Settings Panel

There are two places to do this:

a. Local dw.json (for sandbox development)

In the root of your project, update dw.json:

{
  "hostname": "your-site.demandware.net",
  "username": "your-user",
  "cartridges": "app_custom:int_absolute_crypto:app_storefront_base"
}

b. Business Manager

In BM:

• Go to: Administration > Sites > Manage Sites > [Your Site] > Settings

• Update the Cartridge Path to include int_absolute_crypto. Place int_absolute_crypto before app_storefront_base so it can override or extend core behavior if needed.

• Go to Administration > Organization > Roles & Permissions > Administrator - Business Manager Modules.

• Select the site you want to enable the Absolute Labs cartridge for, then find and select Absolute Crypto Settings in the list, and click Update.

3. Import Metadata

Import the metadata folder into Business Manager.

1. Go to Administration > Site Development > Site Import & Export

2. Upload the .zip file or point to the metadata/ folder

3. Import the archive into your site

This sets up the Payment Processor and Method as well as the services to handle payment confirmation and refunds with the payment gateway webhooks.

4. Configure the Cartridge

In your Salesforce Business Manager, go to Merchant Tools > Site Preferences > Absolute Crypto settings > Account settings, and make sure to provide the following elements:

• Environment: Test is used to validate the integration without requiring actual on-chain transactions. Choose Production when you go live

• Fill in your Crypto.com secret key and publishable key

• Fill in your Absolute Labs API Key under absolute labs key

• Copy the Webhook URL display on this page, then head to your Crypto.com merchant dashboard, and open Integration > Webhooks

• Click the Add Webhook button and then paste the Webhook URL copied into Payload URL, then a signature secret for webhook is generated

• Paste this signature secret in the Configure page of Absolute Crypto addon

5. Enable the Payment Method

Now that the method exists, enable it on your site.

• Go to Merchant Tools > Ordering > Payment Methods

• Make sure the new payment method AbsoluteCrypto is active

• Assign it to the ABSOLUTECRYPTO processor added previously through the metadata

• Enable it for your site or organization

6. Update Checkout UI to Show the Payment Option

This steps depends on the specifics of your website: This is where you add the crypto payment option to your frontend. The cartridge does not provide any specific element for you to leverage here.

The only requirements are properly passing the payment option in the form and hooking it into SFRA's checkout JS to handle selection and form validation.

Assuming your interface leverages radio buttons, it would for instance look as follows in your app_custom/cartridge/templates/default/checkout/billing/paymentOptions.isml ISML template:

<div class="payment-option">
    <input type="radio" name="paymentMethod" value="ABSOLUTECRYPTO" id="paymentMethod_ABSOLUTECRYPTO">
    <label for="paymentMethod_ABSOLUTECRYPTO">Pay with Crypto</label>
</div>

7. Verify Your Integration

You are now all set with the integration. You can run through common test cases such as succesful payment, cancelled, or delayed.