> ## Documentation Index
> Fetch the complete documentation index at: https://docs.hyzl.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Connect payments

> Connect RevenueCat or Stripe so that Hyzl can stop recovery after payment.

A payment provider records purchases and subscriptions. Hyzl checks that provider before each scheduled text or call.

A payment connection gives Hyzl the answer. It does not give Hyzl control of charges or refunds.

[Open **Payment connections**](https://hyzl.app/connect/)

Hyzl does not charge, refund, or change purchases through this connection. It uses one payment provider for each app.

## Choose a provider

Choose the provider that knows who paid:

| Provider   | Use it when                                            |
| ---------- | ------------------------------------------------------ |
| RevenueCat | RevenueCat manages your app's subscriptions.           |
| Stripe     | You collect purchases or subscriptions through Stripe. |

One connected provider completes this setup step. If a payment check fails, recovery waits and does not contact the person.

## Connect RevenueCat

1. Select **Connect RevenueCat**.
2. Sign in to RevenueCat.
3. Choose only the RevenueCat project for this app.
4. Select **Use this project**.
5. Wait for **RevenueCat connected.**

You do not paste a RevenueCat key into Hyzl.

The `userId` in each paywall event must exactly match the value from `Purchases.logIn()`. A different value can make a paid person appear unpaid.

After connection, the card shows the project name and **Connected to RevenueCat**. Select **Change project** to use another project.

Select **Connect a different account** to use another RevenueCat account. The new account replaces the current account after a successful connection.

If RevenueCat has one project, Hyzl selects it in the project list. If no project appears, review the RevenueCat account.

## Connect Stripe

1. Select **Connect Stripe**.
2. Sign in to Stripe.
3. Authorize the connection.
4. Return to Hyzl.
5. Wait for **Stripe connected.**

Stripe offers a read-and-write connection. Hyzl only reads payment and subscription data. Hyzl never charges, refunds, or changes anything.

Connect a live Stripe account. A Stripe test account cannot complete this setup step.

After connection, the card shows **Connected to Stripe**. Select **Connect a different account** to replace the current Stripe account.

## Switch providers

Select the unconnected provider to replace the current provider. Hyzl asks for confirmation before the switch.

The dialog names both providers. Select **Keep Stripe** or **Keep RevenueCat** to cancel.

A successful switch changes future payment checks. The existing provider remains active until the new connection succeeds.

## Read the connection status

| Status                | Meaning                                               |
| --------------------- | ----------------------------------------------------- |
| **Not connected**     | This provider does not check payments for the app.    |
| **Choose a project**  | RevenueCat needs a project selection.                 |
| **Connected**         | The provider account is saved.                        |
| **Connection broken** | Hyzl cannot use the saved connection. Recovery waits. |

A connected card also shows one payment check state:

* **Last payment check passed.** A payment check succeeded within the past 24 hours.
* **No check yet. The first recovery event will check payment.** No recent check exists.
* **Your connection needs attention.** Reconnect the provider before recovery continues.

## After you return to Hyzl

Hyzl can show **Checking your connection.** after the provider sends you back. Select **Refresh connection** to load the saved result.

If the connection succeeded, Hyzl shows **Your payment connection is saved.** During setup, select **Get your number** to continue.

## Problems and retries

If Hyzl cannot open a provider, the card shows an error. Check your connection and sign-in, then try again.

An expired connection link needs a fresh connection. A signed-out session needs a new sign-in.

If RevenueCat shows **Loading your RevenueCat projects**, wait for the list. Use the retry control if RevenueCat does not answer.

If the page cannot load your app data, it shows **Couldn’t load this page**. Select **Try again**.

While the page shows **Connection broken**, Hyzl holds scheduled recovery until it can confirm payment.