> For clean Markdown of any page, append .md to the page URL.
> For a complete documentation index, see https://docs.ordergroove.com/llms.txt.
> For AI client integration (Claude Code, Cursor, etc.), connect to the MCP server at https://docs.ordergroove.com/_mcp/server.

# Routing the Update payment link to Frictionless Payments

Learn how to override your Subscription Manager theme so the "Update payment" link sends customers to Frictionless Payments.

Out of the box, the Subscription Manager decides where "Update payment" goes by checking your platform settings in order, stopping at the first match:

1. An external payment URL, if both `external_payment_enabled` and `external_payment_url` are set. This is checked first, so it applies on any platform — including Shopify.
2. [Shopify's customer accounts interface](/lifecycle/sm/shopify-payment-updates), if you're on Shopify New Accounts.
3. Ordergroove's Shopify billing flow, if you're on Shopify without New Accounts.
4. Nothing at all, if you're not on Shopify and no external payment URL is set. The conditional has no final `else`, so the link doesn't render.

If you're set up with Frictionless Payments, you'll want the link to bypass that logic and open your Frictionless Payments page instead.

---

## Before you start

You must already be configured with Ordergroove's [Frictionless Payments integration](https://help.ordergroove.com/hc/en-us/articles/51047255729427-Frictionless-Payment-Update) before you apply this override. The override only changes where the link points — it does not enable the integration. If you're not sure whether Frictionless Payments is set up for your account, check with your Ordergroove contact first.

You'll also need a Subscription Manager v25 theme and access to the [Advanced editor](/lifecycle/sm/advanced-editor).

---

## Apply the override

Open the [Subscription Manager page in Ordergroove](https://rc3.ordergroove.com/subscriptions/manager/) and find the theme you want to change. We recommend using a draft theme rather than your live theme, so you can preview the change before it reaches customers.

In the Theme designer, switch to the Advanced editor tab and find the `order-summary/payment-details.liquid` file under **Views**. Inside the `{% if order.status != 'SEND_NOW' %}` block, find the conditional that resolves the payment URL:

```liquid
{% if 'external_payment_enabled' | setting and 'external_payment_url' | setting %}
  {% set payment_url =  'external_payment_url' | setting %}
  {% include 'order-summary/payment-link' %}
{% elseif 'platform' | setting("shopify") == 'shopify' %}
  {% if 'shopify_customer_accounts_version' | setting === 'new_customer_accounts' %}
    {% set shop_id = 'shopify_shop_id' | setting %}
    {% set payment_url = "https://shopify.com/" + shop_id + "/account/profile" %}
    {% include 'order-summary/payment-link' %}
  {% else %}
    {% include 'order-summary/change-billing-shopify' %}
  {% endif %}
{% endif %}
```

The exact code and line numbers vary by template version and by the customizations made to your theme. Older v25 themes render the link inline with an `<a>` element instead of including `order-summary/payment-link`, in which case you may need to make further customizations. Replace the whole conditional either way.

Replace that entire block with:

```liquid
{% set payment_url = '/apps/subscriptions/payment-update?source=sm' %}
{% include 'order-summary/payment-link' %}
```

`payment_url` is a relative path, so it resolves against your storefront domain. Save the changes to the theme.

---

## Verify the change

1. Load the Subscription Manager as a customer.
2. Select "Update payment". A new tab opens at `/apps/subscriptions/payment-update?source=sm` on your storefront domain, showing the Frictionless Payments page.
3. Complete a payment update, then return to the Subscription Manager and confirm the subscription's payment method reflects the new card.

Use the editor's [preview functionality](/lifecycle/sm/theme-editor#additional-theme-editor-features) to check the change before it goes live. When you're ready, publish the theme.