> For the complete documentation index, see [llms.txt](https://help.dollarlabs.io/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://help.dollarlabs.io/dollarback-store-credit/integrations/subscription-platforms/redeem-shopify-store-credit-on-upcoming-subscription-renewal.md).

# Redeem Shopify Store Credit on upcoming subscription renewal

Let customers spend DollarBack store credit on an upcoming Recurpay subscription renewal

Shopify doesn't apply store credit to subscription renewals on its own, because a renewal doesn't go through checkout. With the **Recurpay** integration, customers can spend their DollarBack store credit on their next renewal from Recurpay's subscription management page.

The customer chooses when to use it: nothing is applied until they redeem credit against a renewal. That is the main difference from [Appstle Subscriptions](/dollarback-store-credit/integrations/subscription-platforms/appstle-subscriptions.md), which applies the balance automatically.

{% embed url="<https://youtu.be/qz2WbQaIHLw>" %}

## Prerequisites

* **Shopify's new customer accounts** enabled (**Shopify admin → Settings → Customer accounts**, then select the new experience).
* **Shopify native store credit** enabled on your store (the **Store credit** toggle under **Shopify admin → Settings → Customer accounts**).
* DollarBack installed and issuing store credit: an earning program, a Flow deposit, or a manual credit.
* Recurpay for your subscriptions. The steps on this page are Recurpay-specific. For Appstle, see [Appstle Subscriptions](/dollarback-store-credit/integrations/subscription-platforms/appstle-subscriptions.md); other subscription apps aren't supported yet, see [Subscription platforms](/dollarback-store-credit/integrations/subscription-platforms.md).

## Turn it on in Recurpay

There is nothing to configure in DollarBack. The work is in Recurpay:

1. Open your **Recurpay** dashboard.
2. Go to **Settings → Apps → Loyalty**.
3. Find **Dollarback** and click **Activate**.
4. If Recurpay asks you to approve more permissions, accept them.

Once it is active, Recurpay can read the customer's store credit balance when they manage their subscription.

## What customers see

1. The customer logs in to their account and opens the **Manage Subscriptions** page.
2. They see an option to **redeem store credit** against the next renewal.
3. They enter the amount of credit to apply, for example `$20`.
4. They confirm. The renewal total goes down by that amount.

For example, a subscription priced at `$23.41` with `$20` of store credit redeemed renews for `$3.41`.

## Earning on renewals

Renewal orders are ordinary Shopify orders, so your purchase cashback programs pay on them like any other order. Two things to check:

* **When a customer pays with store credit** on the [Special order types](/dollarback-store-credit/settings/special-order-types.md) card decides what a renewal paid partly with credit earns.
* **Restrict to sales channels**: a renewal order can come from Recurpay's sales channel rather than **Online Store**. If a program has sales channels ticked and that channel is not one of them, the program skips those renewals. Leave all channels unticked, or tick Recurpay's channel too ([Restrict to sales channels](/dollarback-store-credit/earning-cashback-programs/set-up-purchase-cashback.md#restrict-to-sales-channels)).

## Verify it works

1. In **Shopify admin → Customers**, open a test customer and add a small store credit amount, for example `$20`.
2. Confirm that **Dollarback** shows as active under **Settings → Apps → Loyalty** in Recurpay.
3. Log in to your storefront as that customer and open **Manage Subscriptions**.
4. Redeem the credit against the next renewal and check that the renewal total drops by the same amount.

## Common issues

If the customer can't see store credit on the subscription page:

* **No balance**: check that DollarBack has issued credit and the customer's store credit balance is above zero.
* **Integration not active**: check that **Dollarback** is activated under **Settings → Apps → Loyalty** in Recurpay.
* **Classic customer accounts**: the customer must use the new customer accounts, not classic accounts.
* **Old session**: ask the customer to log out and log in again.

Recurpay owns the subscription management page, so for anything about how it behaves, Recurpay's support can see things we can't. For anything on the DollarBack side, contact us through the in-app chat or email.

## Ideas

* **Reward every renewal**: your purchase cashback programs already pay on renewal orders, so each renewal builds credit toward the next one.
* **Credit to keep a subscriber**: add credit to a customer who is about to cancel, by hand or with a Shopify Flow workflow ([Shopify Flow: triggers and actions](/dollarback-store-credit/integrations/shopify-flow-triggers-and-actions.md)).

## Related articles

* [Subscription platforms](/dollarback-store-credit/integrations/subscription-platforms.md)
* [Appstle Subscriptions](/dollarback-store-credit/integrations/subscription-platforms/appstle-subscriptions.md)
* [How customers spend their credit](/dollarback-store-credit/spending-store-credit-and-rewards/how-customers-spend-their-credit.md)
* [Special order types](/dollarback-store-credit/settings/special-order-types.md)