Savby logo
Sign inGet started

Overview

Getting Started

Go from zero to recovering failed payments in under five minutes. No code changes required.

Prerequisites

  • A Stripe account (test or live mode)
  • At least one active subscription product in Stripe
  • An email address for your Savby account

Setup steps

01

Create your account

Go to savby.io/signup and create an account using your email or Google. A new organisation is created automatically — you are its Owner.

After signing up you will be taken to the onboarding flow. No credit card is required to start.

02

Connect your Stripe account

Click Connect Stripe on the onboarding screen. You will be redirected to Stripe to authorise Savby via OAuth. Savby requests read access to your customers and subscriptions, and the ability to pay invoices on your behalf.

Once you approve, Stripe sends Savby an access token which is encrypted with AES-256-GCM and stored securely. Savby immediately syncs your existing customers and subscriptions in the background.

Test mode: You can connect a Stripe test mode account to try everything safely before going live.
03

Choose a plan

Select the plan that fits your volume. The Plans & Billing page has a full comparison. You can start on the free plan to evaluate Savby with up to 10 recovery cases per month.

04

Your first failed payment

The moment Stripe sends an invoice.payment_failed webhook, Savby:

  • Reads the decline code from the invoice
  • Maps it to the optimal recovery strategy
  • Schedules retry attempts or customer notification
  • Creates a Recovery Case you can track on the dashboard

No code changes are required in your application. Savby listens to your Stripe webhooks automatically after the Connect step.

Testing with Stripe CLI

To test locally, you can forward Stripe events to a running Savby instance using the Stripe CLI:

stripe login
stripe listen --forward-to http://localhost:4000/api/webhooks/stripe
stripe trigger invoice.payment_failed

The CLI forwards real-time events to your local API. Savby will process the event and create a recovery case visible on the dashboard.

Learn more about how Savby processes payments in How It Works, or browse the complete Decline Codes reference.

PreviousIntroductionNextHow It Works