Salesforce Commerce Cloud
Last updated: April 29, 2022
Get started with our Salesforce Commerce Cloud (SFCC) integration, from installing the LINK cartridges to making your first test payment.
Information
You can use our LINK cartridges with Storefront Reference Architecture (SFRA) or controller-based SiteGenesis.
- Manual capture, void, and refund from the Hub and the SFCC Business Manager
- Multiple partial refunds via the Business Manager
- Embedded payment form using our full card details API
- Saved cards (stored credit cards)
- Invoice generation
- 3D Secure 2.0
- Webhook notifications for up-to-date payment statuses
- Gift certificates on SiteGenesis
If you haven't already, create a test Checkout.com account.
To set up our SFCC integration, you'll need three API keys: a secret one, a public one, and a private shared one. The first two are generated automatically upon account creation. The last one is generated when you create a webhook for your business.
Information
Webhooks are notifications that we send when an event occurs on your account. For example, when a payment is captured. These are used by the SFCC plugin to update the status of an order. Read more about webhooks.
- Log in to your test account on the Hub sandbox.
- In the left menu, go to Settings > Channels, and make a note of your secret and public API keys.
- Scroll down to the Webhooks section of the page and select New webhook.
- Enter the following URL, replacing
example.comwith the URL of your shop:example.com/CKOMain-HandleWebhook.
Note
Correctly configuring your webhooks is important; if they're incorrectly formatted, the plugin will not work.
- Select API - v2.0.
- Tick Select all, then select Create webhook.
- Click on the webhook you just created, and make a note of the private shared API key.
- Download our installation package from GitHub. This package includes the frontend cartridges for SFRA (
int_checkoutcom_sfra) and SiteGenesis (int_checkoutcom), as well as the backend cartridge (bm_checkoutcom), which is compatible with both SFRA and SiteGenesis. - Upload the relevant cartridges to your server, using a tool like UX Studio:
- If you're using SFRA, install
int_checkoutcom_sfraandbm_checkoutcom. - If you're using SiteGenesis, install
int_checkoutcomandbm_checkoutcom.
- If you're using SFRA, install
- Log in to your Business Manager account, and go to Administration > Sites > Manage Sites > [your site] > Settings.
- In the Cartridges field, add one of the following to the front of the cartridge path and select Apply:
- For SFRA, add
int_checkoutcom_sfra:bm_checkoutcom:. - For SiteGenesis, add
int_checkoutcom:bm_checkoutcom:.
- For SFRA, add
SFRA example:
- In a file browser, open the
metadatafolder in the installation package you downloaded earlier, then go into thesitessubfolder. - Rename the default named folder to the name of the site for which you want to import the cartridge:
- For SFRA, rename the
RefArchGlobalfolder to the name of your site. - For SiteGenesis, rename the
SiteGenesisGlobalfolder to the name of your site.
- For SFRA, rename the
- Navigate back to the package's root folder, and zip the
metadatafolder. - Next, log in to Business Manager and go to Administration > Site Development > Site Import & Export.
- Under Upload Archive, select Local and then Choose file.
- Find the
metadata.zipyou just created, select Open and then Upload.
If you use SiteGenesis, you also need to edit the payment methods template in order to show the Checkout.com payment option on the billing page.
To do so, add the following code snippet to the /app_storefront_core/cartridge/templates/default/checkout/billing/paymentmethods.isml file:
Information
If your site is also using the default SiteGenesis credit card form, place the code of the form (found in the core paymentmethods.isml template file) after the <iselse> block in the snippet shown above.
This will display the Checkout.com credit card form if enabled in the custom preferences, and display the default Site Genesis credit card form if not.
Note
The Checkout.com credit card form is not compatible with the default SiteGenesis credit card form. Please disable the default credit card form if using the Checkout.com credit card form, and vice versa.
- Log in to Business Manager, and go to Merchant Tools > Site Preferences > Custom Preferences > Checkout.com Sandbox API.
- Set ABC or NAS Enabled to ABC.
- Enter the public key, secret key, and private shared key from your sandbox Hub account, and select Save.
- Go back to the custom site preferences page and select Checkout.com Global Settings.
- Make sure Enable is set to Yes, to enable the Checkout.com card payment form.
- Set Mode to Sandbox, so you can start testing card payments.
- Enter your business name (the name of your shop), and fill in the business address, city and country fields.
- Choose whether or not you want to Auto capture your payment. Set to Yes if you want your payment to be captured (i.e., the money due from the customer's account is moved into your account) immediately after being authorized. Set to No if you want to capture the payment manually.
- If you set Auto capture to Yes, you can specify the delay (in hours) before the payment is captured. For example, entering
1.5would capture the payment one hour and 30 minutes after authorization. The default is0. - Select Save.
That's it! You're ready to start testing card payments.
- Go to your storefront and add a product to your cart.
- Go to your cart and proceed to the checkout.
- Enter the required billing details. You can put anything here, though we recommend using a real email address so you can receive the order confirmation.
- Select the Pay by Card with Checkout.com method.
- Enter test card details (you can use any future expiry date).
- Select Place order, and you will be redirected to the order confirmation page. If you entered a real email address in the billing details, you'll also receive an order confirmation email.
- Log in to Business Manager.
- Go to Merchant Tools > Ordering > Orders and select Find to show your orders. Your test order will be displayed there with a
Createdstatus. This indicates that the payment has been successfully authorized and captured. The transaction will also appear in the Payments section of your sandbox Hub account.
You can now either go live as-is or extend your configuration.
You'll find more test cards and a range of scenarios to trigger in our testing guide.
Note
If this test does not work, first check you have configured your webhooks correctly. For the plugin to work, they must be formatted correctly. If you have configured them properly, check your server; if it's password-protected or it restricts unfamiliar IP addresses, it may be blocking webhook notifications. Contact our Support team at [email protected] if you need help.
If you're happy with the outcome of your testing and want to start taking payments right away, please contact our Sales team in order to move to a live account.
Before you go live, remember to:
- Switch the cartridge Mode from Sandbox to Live in Business Manager.
- Enter your live public, secret and private shared API keys in the Checkout.com Live API section of Custom Site Preferences.
- Configure the webhook URLs in your live Hub account.
You can extend your integration to add more payment methods, use 3D Secure payments, and more. Read our article about going further with SalesForce Commerce Cloud.