Connect your payment platform
Setup takes under 5 minutes. Pick your platform below.
Stripe
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.
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/stripeEnable these events:
invoice.payment_failedinvoice.payment_succeededcustomer.subscription.deletedLemonSqueezy
Get your API key
In LemonSqueezy, go to Settings → API. Create a new key with Read permissions. Paste it in Dashboard → Accounts.
Add the webhook
Go to Settings → Webhooks in LemonSqueezy and create a new webhook pointing to:
https://retriby.app/api/webhooks/lemon-squeezyEnable these events:
subscription_payment_failedsubscription_payment_successsubscription_payment_recoveredPaddle
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.
Add the webhook (Alerts)
In Paddle, go to Developer Tools → Alerts / Webhooks and add:
https://retriby.app/api/webhooks/paddleEnable these events:
subscription_payment_failedsubscription_payment_succeededGumroad
Get your access token
In Gumroad, go to Settings → Advanced → Applications and create an access token. Paste it in Dashboard → Accounts.
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