Setup Guide

Connect your payment platform

Setup takes under 5 minutes. Pick your platform below.

Stripe

Step 1

Connect via OAuth

Go to Dashboard → Accounts and click "Connect Stripe". You'll be redirected to Stripe to authorize Retriby as a Connect app. No API keys needed.

Step 2

Webhook (optional — only for direct accounts)

If you're using a direct Stripe account instead of Connect, add the following webhook URL in your Stripe dashboard under Developers → Webhooks:

https://retriby.app/api/webhooks/stripe

Enable these events:

invoice.payment_failedinvoice.payment_succeededcustomer.subscription.deleted

LemonSqueezy

Step 1

Get your API key

In LemonSqueezy, go to Settings → API. Create a new key with Read permissions. Paste it in Dashboard → Accounts.

Step 2

Add the webhook

Go to Settings → Webhooks in LemonSqueezy and create a new webhook pointing to:

https://retriby.app/api/webhooks/lemon-squeezy

Enable these events:

subscription_payment_failedsubscription_payment_successsubscription_payment_recovered

Paddle

Step 1

Get your Vendor ID and API Key

In Paddle, go to Developer Tools → Authentication. You need your numeric Vendor ID and an API key. Paste both into Dashboard → Accounts.

Step 2

Add the webhook (Alerts)

In Paddle, go to Developer Tools → Alerts / Webhooks and add:

https://retriby.app/api/webhooks/paddle

Enable these events:

subscription_payment_failedsubscription_payment_succeeded

Gumroad

Step 1

Get your access token

In Gumroad, go to Settings → Advanced → Applications and create an access token. Paste it in Dashboard → Accounts.

Step 2

How Retriby detects failures

Gumroad does not support payment failure webhooks. Retriby polls your sales data every hour to detect subscriptions that have ended or been cancelled unexpectedly.

FAQ

Does Retriby ever see my customers' card data?

No. Retriby only reads webhook event metadata — amounts, email addresses, and status codes. Card numbers never leave your payment processor.

What happens if Retriby is down when a payment fails?

Stripe, LemonSqueezy and Paddle retry webhooks for up to 72 hours. Gumroad uses polling so failures within the last hour are always caught on the next poll.

Can I test the integration?

Yes. Use your payment processor's test mode and trigger a test failed payment. You'll see it appear in your Retriby dashboard within seconds (Stripe/LS/Paddle) or within the hour (Gumroad).

What email address do recovery emails come from?

By default: recover@retriby.app. On Pro/Agency plans you can set a custom from-email in Dashboard → Settings.

Still need help?

Email us and we'll help you get set up — usually within a few hours.

support@retriby.app