Skip to main content

Recover failed membership payments

Retry failed renewal payments automatically, and choose what happens when every retry fails.

When a member’s renewal payment fails, for example because their card expired or was declined, Failed Payment Recovery emails the member and charges them again on the schedule you choose. If every attempt fails, Appstle cancels or pauses the membership, or skips that renewal. You keep members whose only problem is their card, without chasing them by hand.

Availability: Failed Payment Recovery is included in every plan and is always on. New stores start with the default settings below.


How it works

When a renewal charge fails, Appstle follows these steps:

  1. Appstle records the failed payment. The membership stays Active while Appstle retries.

  2. Appstle emails the member the Transaction Failed email. It sends one after every failed attempt.

  3. After the number of days you set, Appstle charges the member again.

  4. If a retry goes through, Appstle creates the renewal order, adds back any membership tags it removed, and the recovery ends.

  5. If the last attempt also fails, Appstle does what you chose for Once the membership reaches the maximum number of failures.

The settings apply to every membership in your store.


Change the settings

  1. In your Shopify admin, open Apps → Appstle℠ Memberships.

  2. Click More, then Failed Payment Recovery under General Settings.

  3. Choose your settings. The table below explains each one.

  4. Click Save.


What each setting does

This table explains each setting and gives its default. You can change any setting at any time.

Setting

What it does

Retry Attempts

The total number of charge attempts for one renewal, counting the first charge that failed. Choose 1 to 10. The default is 8, which means up to 7 retries.

Day Before Retrying

How many days Appstle waits after a failed attempt before it tries again. Choose 1 to 10 days. The default is 1 day.

Once the membership reaches the maximum number of failures

What Appstle does when the last attempt fails: Cancel Membership (the default), Pause Membership or Skip failed Order. See the next section.

Remove customer tag after last retry attempt

Turn it on to keep members’ membership tags until the last attempt has failed. It’s off by default. See the note below.

Important: While Remove customer tag after last retry attempt is off, Appstle removes the member’s membership tags as soon as an attempt fails and a retry is still to come. Anything that depends on those tags stops working during the retries. Appstle adds the tags back when a retry goes through. Turn the setting on to keep the tags until the last attempt has failed.


Choose what happens when every attempt fails

The last attempt is the one that uses up your Retry Attempts. These are the three actions:

Action

What happens

Cancel Membership

Appstle cancels the membership and emails the member the cancellation email. The member’s tags are removed. This is the default.

Pause Membership

Appstle pauses the membership and emails the member the paused email. The member’s tags are removed. The membership stays paused until it is resumed.

Skip failed Order

Appstle skips the unpaid renewal, and the member is charged again on their next billing date. The membership stays Active, and the member gets no cancellation or pause email. Any tags Appstle removed during the retries stay removed until a later payment goes through. To avoid that, turn on Remove customer tag after last retry attempt.

The cancellation and pause emails are the Membership Canceled and Membership Paused templates. You can edit them in More → Email Settings.


Edit the failed payment email

The Transaction Failed email tells the member that the payment didn’t work and sends them to the member portal to fix it. To change it:

  1. Click More, then Email Settings under Subscriber Acquisition & Automation.

  2. Click Transaction Failed in the list.

  3. Change the Subject under Email Sender Information, or the text under Heading and Content.

  4. Click Save.

In the email list, Transaction Failed shows an Active or Inactive badge. While it’s Inactive, members get no message about the failed payment, but Appstle still retries the charge. To turn it on, select its checkbox and click Active Email.


What members see

The email’s button opens the member portal, where the member asks Shopify for a link to update their payment details:

  • In Shopify customer accounts, the member opens their membership, clicks the pencil icon next to Update Payment, then clicks Send Email. Members who pay with Shop Pay are told to update their payment method on the Shop Pay website instead.

  • In the Appstle member portal, the member opens their membership and clicks Update Payment.

Shopify then emails the member a secure link. Updating the payment method doesn’t charge the member right away. Appstle charges it at the next retry on your schedule, or sooner if you use Attempt Billing.


What you see

While a payment is being retried, the membership’s page in your admin shows a banner: Payment failed. Appstle is retrying it. It says which attempt failed (for example, “Attempt 2 of 8 failed”), when the next retry is due, and what happens if every retry fails. Click View Past Orders to see the failed charges, or Failed Payment Recovery settings to open these settings.

In the membership’s Past Orders tab, each failed order shows the reason Shopify gave, for example a declined card. The three-dot menu next to a failed order has these actions:

  • Attempt Billing charges the member again right away, for example after they update their card. It isn’t included in every plan. If your plan doesn’t include it, the app tells you when you click it.

  • Disable Retry stops Appstle from retrying that order. Enable Retry turns retrying back on.

The membership’s Activity Logs tab records each step. Look for these events:

Event

What it means

Send Transaction Failed Email

The failed payment email was sent to the member.

Retry Disabled

Appstle stopped retrying. This happens when every attempt has failed, when a payment goes through, or when the membership is paused or cancelled.

Dunning Cancelled, Dunning Paused or Dunning Skipped

The action you chose was applied to the membership.

Tag Removal Scheduled

Appstle is removing the member’s membership tags.


Things to know

  • Appstle retries only memberships that are Active. If a membership is paused or cancelled between attempts, it isn’t charged again.

  • On the last failed attempt, the member gets the Transaction Failed email and, if you chose Cancel Membership or Pause Membership, the cancellation or pause email too.

  • If the member’s bank asks them to confirm a renewal payment (for example, with 3D Secure), Appstle doesn’t retry it. It pauses the membership and sends the Security Challenge email so the member can confirm the payment. When they do, the membership is active again.

  • If a member’s payment for an upgrade fails, Appstle doesn’t retry it. It puts the membership back the way it was before the upgrade and sends the Transaction Failed email.


FAQs

Why did a member lose access after one failed payment?

By default, Appstle removes the member’s membership tags as soon as an attempt fails and a retry is still to come. Anything that depends on those tags stops working during the retries, and the tags come back when a retry goes through. To keep the tags until the last attempt has failed, turn on Remove customer tag after last retry attempt, then click Save.

Why didn’t Appstle retry a failed payment?

Appstle retries only when all of these are true:

  • The membership is Active.

  • The number of days in Day Before Retrying has passed since the last attempt.

  • The membership hasn’t used up its Retry Attempts. The first charge counts as attempt 1.

  • Retrying is on for that order. If someone clicked Disable Retry in Past Orders, click Enable Retry, then Attempt Billing to charge the member now.

Can I turn off retries?

Yes. Set Retry Attempts to 1 attempt. Appstle then doesn’t retry, and the action you chose applies as soon as the first charge fails.

Does the member have to do anything?

If the card is valid again, no: Appstle tries it on the next retry. If the card expired or was replaced, the member should update their payment method from the member portal, as described in “What members see” above.

Need help? Email [email protected] and tell us your store address.

Did this answer your question?