Connect RevenueCat

The App Store, the Play Store, or RevenueCat-managed web billing may bill your subscriptions. Revenue Recovery then connects through RevenueCat instead of Stripe. The recovery calls work the same way. What differs is how a save is funded. Apple and Google do not let anyone apply a discount to a subscription directly. The member therefore redeems a RevenueCat save through App Store offer codes, from a pool you provide.

​

Connect RevenueCat

1. Go to Integrations in the sidebar (under General)
2. Find the RevenueCat card
3. Start the connection

The New workflow wizard on the Revenue Recovery Workflows page is the other route. Its first step is the connection. Once you connect, your RevenueCat recovery workflow appears on Workflows, alongside any Stripe workflow. Each provider gets its own workflow with its own offer, triggers, and results.

​

Connection health

The RevenueCat card on Integrations shows the state of your connection:

• Disconnected (red): the connection broke, so Revenue Recovery has stopped for your account. This usually means the authorization hyzl holds expired or was revoked in RevenueCat. Only you can restore it: click Reconnect on the card and approve the connection again.
• Status unavailable (grey): hyzl could not read your connection just now. It is a temporary glitch and does not mean you are disconnected. Click Retry to check again.

Your App Store Connect key has its own health message. It is inside Manage codes on the Workflows page, not on the Integrations card:

• Apple rejected your App Store Connect key: your key is still on file, but Apple refused it. Follow the guidance in the dialog. Replace a revoked key with a new one from App Store Connect. A key missing permissions needs the Marketing role or higher. The same message shows on the offer-code setup step.

​

Offer codes

RevenueCat saves are funded from your Apple offer-code pool rather than a percentage discount you set in hyzl. The offer-code setup lives on the Workflows page behind Manage codes:

• Your App Store Connect key, so hyzl can work with your offers
• Your code batches, which are the offer codes you have generated in App Store Connect
• Your remaining inventory, so you can see when the pool is running low

When a member accepts on a call, hyzl texts them a redemption code right after. See Offer Texts. If your code pool runs empty, calls that would waste a member’s yes pause automatically. A banner on Analytics tells you what happened. Calling resumes on its own the moment you upload more codes.

​

Phone numbers

hyzl reads the member’s phone number from the reserved $phoneNumber subscriber attribute in RevenueCat. See Phone Numbers for how to set it and check your coverage.