📍 Bolt Help / Third-Party Connectors / Subscriptions & Memberships / Connect Ordergroove with Bolt

Connect Ordergroove with Bolt

The Ordergroove integration enables merchants to offer subscriptions to their customers. It is currently compatible with the SFCC platform.

About OrderGroove Product Subscriptions

When a shopper visits a product page in your storefront that you’ve made available for subscriptions, they can choose to make a one-time purchase or sign up for a recurring purchase.

Example product available for subscriptions

Bolt is partnering with Ordergroove to bring you the ability to offer subscriptions, with the addition of the extensive Bolt Network and our trusted authentication and payments orchestration layers.

Benefits

Merchant Benefits Shopper Benefits
Move from a one-and-done transaction model to curating ongoing, frictionless relationships. Gain a personalized shopping experience.
Increase customer lifetime value (CLV). Enjoy a more convenient method of paying for regularly used products.
Lock in predictable recurring revenue. Save through promotions or discounts at enrollment.
Grow average order value (AOV).

Subscription Management

Ordergroove’s RC3 dashboard enables you to manage shoppers' subscriptions and perform other relationship management actions.

If a transaction includes a product subscription, the transaction details view in the Bolt Merchant Dashboard includes a link to the subscription management area in the RC3 dashboard.

Set Up Ordergroove Integration

Before You Start

Merchants must have implemented the following Bolt settings:

Merchants must have completed the following Ordergroove setup steps:

  • Download the Ordergroove integration into your workspace.
  • Use the Ordergroove SFCC Installation Guide (included in the downloaded cartridge files) to set up the cartridge.
  • Grant Bolt access to your Ordergroove RC3 dashboard (contact your Bolt customer success manager to determine who needs access).

INFO

If you have existing subscriptions with Ordergroove, please contact your Bolt customer success manager to perform a migration so your existing subscriptions continue to process correctly.

Implementation

Connect Bolt and Ordergroove

Obtain Ordergroove Account Keys

Contact your Ordergroove account representative to obtain the following keys:

  • API private key
  • API username
  • Customer private key
  • Public ID
  • SFTP username
  • SFTP password
Obtain Ordergroove Webhook Key
  1. Log into the Ordergroove RC3 dashboard and navigate to Account > Developers > Webhooks.
  2. Locate Verification Key and select Show.
  3. Copy this key for use in a later step. This is the webhook private key.
Add Keys to Bolt

Contact your Bolt customer success manager and send the six Ordergroove account keys and the Ordergroove webhook private key. The CSM will work with the technical team to connect your Bolt and Ordergroove accounts.

Enable Ordergroove Webhook

  1. Log into the Ordergroove RC3 dashboard and navigate to Account > Developers > Webhooks.
  2. Select Enabled.
  3. Add the URL for your environment type:
    • Prod: https://api.bolt.com/v1/webhooks/ordergroove
    • Sandbox: https://api-sandbox.bolt.com/v1/webhooks/ordergroove

Configure Payment Method Updater

To enable shoppers to update their payment method from their merchant storefront account, embed the payment method updater component in the page where a shopper can manage their subscriptions.

The appropriate steps vary based on whether you have implemented Bolt SSO.

Load Bolt Script
  1. Log into the Ordergroove RC3 dashboard and navigate to Subscriptions > Management Interface > Code Editor.
  2. Locate the /scripts folder and click script.js.
  3. Paste the following code at the bottom, replacing EMBED_SCRIPT with the appropriate environment script:
    • Production: https://connect.bolt.com/embed.js
    • Sandbox: https://connect-sandbox.bolt.com/embed.js


With SSO



Without SSO


By default, this component renders the payment method updater in a new tab. For this integration, we recommend overriding this functionality and embedding the component in your storefront for a more seamless user experience.

  1. Locate the /views folder and click billing-shipping-details.liquid. This file controls the subscription management page.
  2. Locate this code block (around line 39):
{% if 'external_payment_enabled' | setting %}
  <a class="og-link og-edit-payment" href="{{ 'external_payment_url' | setting }}">{{ 'shipment_unsent_footer_billing_edit' | t }}</a>
{% endif %}

and replace it with the following code:


With SSO



Without SSO


Update Card Details in Storefront

To trigger updatePaymentMethod() to update the card details in the storefront UI, add data-bolt-id elements to the subscription management page.

  1. Locate the /views folder and click billing-shipping-details.liquid. This file controls the subscription management page.
  2. Locate this code block (around line 28):
<div og-payment-id="{{payment.public_id}}">
      <span class="og-payment-type">
          {{ payment.cc_type }} {{ payment_method_names[payment.payment_method] }}
      </span>
      {% if payment.cc_number_ending %}
        {{ 'form_billing_ending_in' | t }}
      {% endif %}
    </div>
    <div class="og-payment-expiration-date">
      {% if payment.public_id %}
        {{ 'form_billing_expiration_date' | t }}
      {% endif %}
    </div>

and replace it with the following:

<div og-payment-id="{{payment.public_id}}">
      <span class="og-payment-type">
          <span data-bolt-id="bolt-billing-cc-type">{{ payment.cc_type }}</span> {{ payment_method_names[payment.payment_method] }}
      </span>
      {% if payment.cc_number_ending %}
        <span data-bolt-id="bolt-billing-last-4" class="og-payment-last-4">{{ 'form_billing_ending_in' | t }}</span>
      {% endif %}
    </div>
    <div class="og-payment-expiration-date">
      {% if payment.public_id %}
        <span data-bolt-id="bolt-billing-expiry-date" class="og-exp-date">{{ 'form_billing_expiration_date' | t }}</span>
      {% endif %}
    </div>

Enable Ordergroove in SFCC

  1. Log into SFCC and navigate to Merchant Tools > RefArch > Site Preferences > Custom Preferences > Ordergroove.
  2. Locate the OrderGrooveEnable setting and set it to yes.

Enable Feature in Ordergroove

Contact Ordergroove and request enablement of the feature Batch order placement.

Set Up Frequencies in Bolt

This one-time setup step ensures that the order frequencies you have configured with Ordergroove match what shoppers see on the product page.

  1. Go to your Ordergroove RC3 dashboard.
  2. Navigate to Experiences > Subscriptions > Enrollment and find the HTML Source section.
  3. In another tab, log into the Bolt Merchant Dashboard and navigate to Settings.
  4. For each frequency that appears in the Ordergroove RC3 dashboard, configure a matching frequency in the Bolt Merchant Dashboard.

WARNING

If you modify the frequency configuration in RC3 in the future, make sure you also modify the frequency configuration in the Bolt Merchant Dashboard to match.

📖On This Page
Filter by Section
Filter by Topic