> For the complete documentation index, see [llms.txt](https://docs.flycode.com/docs/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://docs.flycode.com/docs/integrations/step-by-step-integrate-flycode-with-recharge.md).

# Recharge integration guide: connect FlyCode to Recharge

Connect FlyCode to Recharge for Shopify subscriptions: install from the Recharge marketplace, change three payment settings, go live, and avoid double dunning.

{% hint style="info" %}
**TL;DR:** Install the FlyCode app from the Recharge App Marketplace, allow third-party integrations in Recharge's payment settings, set Recharge's max retries to 8 with "Do nothing" when the maximum is reached, agree a launch date, and go live. FlyCode then recovers failed Recharge charges with machine-learning retry timing and coordinated messaging, while Recharge and Recharge Retain keep running everything else.
{% endhint %}

## Who this is for

Shopify merchants running subscriptions on Recharge, with or without Recharge Retain. FlyCode does not replace Recharge; it takes over failed payment recovery, the area where it focuses all of its product and AI investment, and Retain continues to handle referrals, rewards, cancellation prevention and win-backs. Top Recharge merchants already run both. See [Recharge and FlyCode: better together](#recharge-and-flycode-better-together) below.

## Prerequisites

* A Shopify store with Recharge installed and an active subscription program.
* Recharge admin access to Payments settings and the App Marketplace.
* A FlyCode account. If you do not have one, [get started](https://www.flycode.com/get-started) or request a [free payment audit](https://www.flycode.com/churn-audit-failed-payments) first to see your recoverable revenue.

## Setup

{% stepper %}
{% step %}

### Get the FlyCode installation link for Recharge

From your FlyCode onboarding or from the Recharge App Marketplace, open the FlyCode app installation link for your store.

<figure><img src="https://lh7-us.googleusercontent.com/ytc52NRaXKYiaZDRm2i0ATfMxey7Aa-esZslTNI7YJk48RxpfUwbCkV1Vv3CkbmwLYQejpX7TRVmlPoDZqsHydm6wawNZ1ogjDHQVbCCAZl5SDu7D-AA8lCV7tDXD4lYCckTGk9EjwnrnfjFBlWzjUM" alt=""><figcaption><p>FlyCode in the Recharge App Marketplace</p></figcaption></figure>
{% endstep %}

{% step %}

### Confirm permissions and install

Review the permissions Recharge shows (read customers, subscriptions and charges; retry charges) and confirm the installation.

<figure><img src="https://lh7-us.googleusercontent.com/-gUMqN-gFG59g4hwBHP8cZsqiVDk3gb36pt0M-LGiHOS5DPXZeNcc98QeofA95B1GtP94baaosUWy3FVHp9gbv26uBsYrdqy1Ia2yTVni_AWRyczyYBaYXVM3c4EYgiDA5ZGsdbOfgq0gF4bO1cBcPU" alt=""><figcaption><p>Permission confirmation</p></figcaption></figure>
{% endstep %}

{% step %}

### Change Recharge's payment settings

In Recharge, open Settings, Payments, and set:

1. **Allow 3rd party integration:** on. This lets FlyCode retry charges.
2. **Max retries:** 8. This keeps the charge in a retryable state for the full recovery window.
3. **When max retries are reached:** "Do nothing". FlyCode manages what happens to unrecovered charges, so Recharge should not cancel or skip on its own.

<figure><img src="https://lh7-us.googleusercontent.com/UThVnfC2IWomEXbHksarlmTBYHAwGxMi6BUIxlRIqjjBHRuEXYZGaEi54BC7ZdXvyh6QnKIEmdPrp9a8jPZfIGad8lMF80-Fj5foXHid65UtSw1eREAtMzVlYFlPXsjHbyL8sqLBJuei0ltBjI9twF0" alt=""><figcaption><p>Recharge payment settings</p></figcaption></figure>
{% endstep %}

{% step %}

### Set the launch date

Agree a go-live date with FlyCode. On activation, FlyCode loads every existing charge in an error state and backfills the error details, so recovery starts on your current failed charges as well as new ones. Backfilling also runs whenever FlyCode receives a webhook for a charge it has not seen before.
{% endstep %}

{% step %}

### Test and go live

FlyCode runs an end-to-end test plan per merchant to confirm every payment option and error type in your store is handled. Once tests pass, FlyCode activates and begins retrying. If you use Recharge's own failed-payment emails or Retain's dunning, decide at this point whether FlyCode or Recharge owns customer messaging so the two do not both email the customer.
{% endstep %}
{% endstepper %}

## How FlyCode behaves on Recharge

* FlyCode acts on all existing and new charges in an error state.
* It retries charges that failed for inventory or configuration reasons as well as card declines.
* It does not retry charges the processor returned as a hard decline; those go to backup payment methods or customer outreach.
* A built-in safeguard never processes a given customer's charge more than 2 times per hour.
* Recovered charges and status updates are written back to Recharge and Shopify, which remain the systems of record.

## Go-live checklist

* [ ] FlyCode app installed from the Recharge App Marketplace
* [ ] Recharge Payments: allow 3rd party integration on
* [ ] Recharge Payments: max retries set to 8
* [ ] Recharge Payments: when max retries reached set to "Do nothing"
* [ ] Messaging owner decided (FlyCode or Recharge/Retain), and the other side's failed-payment emails turned off
* [ ] Launch date agreed; test plan passed

## Troubleshooting

**FlyCode is not retrying charges.** Check that "Allow 3rd party integration" is on in Recharge Payments and that the app installation completed with permissions confirmed.

**Recharge cancelled or skipped subscriptions before FlyCode finished recovering.** "When max retries are reached" is not set to "Do nothing", or max retries is below 8.

**Customers received duplicate emails.** Both FlyCode and Recharge (or Retain) are sending failed-payment messages. Choose one owner.

**A charge that failed for an inventory or configuration reason keeps failing.** FlyCode will retry it, but the underlying cause (out-of-stock variant, invalid shipping rate) needs fixing in Shopify or Recharge.

## FAQ

**Can I keep Recharge Retain?** Yes. Retain handles referrals, rewards, cancellation prevention and win-backs; FlyCode handles failed payment recovery. Turn off Retain's failed payment recovery so only one engine retries.

**Do I need a developer?** No. Installation is an app install plus three settings.

**Which Shopify apps does FlyCode support?** Recharge, Skio and Stay AI, plus Shopify's native subscription payments through other supported apps. See [Supported payment and subscription platforms](https://docs.flycode.com/docs/integrations/supported-payment-and-subscription-platforms).

## Recharge and FlyCode: better together

Recharge Retain gives you a retention suite built into your subscription stack: referrals, rewards, cancellation prevention, win-backs and failed payment recovery. FlyCode is the payment recovery specialist that integrates with Retain and focuses all of its AI investment on granular failed payment diagnosis (issuer responses, BIN patterns, soft versus hard decline paths, network tokens, dunning timing by reason, message and channel personalization by risk and LTV) and recovery. Together you get lifecycle growth and best-in-class failed payment performance without vendor conflicts. Some of the brands running both:

<figure><img src="https://857825088-files.gitbook.io/~/files/v0/b/gitbook-x-prod.appspot.com/o/spaces%2FedoXR9BFShbgporwvi7n%2Fuploads%2F1GkHU6YJsEnTn2babTv5%2FFlycode%20x%20Recharge%20Logos%20(1).png?alt=media&#x26;token=2540520a-00c2-4dae-9606-29a2a8543806" alt=""><figcaption><p>Shared Recharge and FlyCode customers</p></figcaption></figure>

[More about our customers](https://www.flycode.com/customers) or [start a free payment audit](https://www.flycode.com/churn-audit-failed-payments).

## Related

* [FlyCode & Shopify](https://help.flycode.com/flycode-and-shopify) in the Help Center
* [How to install FlyCode on Skio](https://docs.flycode.com/docs/integrations/how-to-install-flycode-on-skio)
* [Recover failed Shopify subscription payments with FlyCode](https://www.flycode.com/shopify/benefits)
* [How FlyCode handles Shopify subscription failed payments](https://docs.flycode.com/docs/integrations/how-flycode-handles-shopify-subscription-failed-payments)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://docs.flycode.com/docs/integrations/step-by-step-integrate-flycode-with-recharge.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.