# Payment Provider

A payment provider handles the checkout flow for paid [Offers](/product/entitlements/offers.md). When a payment provider is connected, members can complete purchases through a hosted checkout page and receive their entitlements automatically on success.

## How It Works[​](#how-it-works "Direct link to How It Works")

When a member selects a paid plan:

1. Allegro creates a hosted checkout session with your connected payment provider.
2. The member is redirected to the provider's checkout page to complete payment.
3. The provider notifies Allegro when payment succeeds.
4. Allegro creates the entitlements defined by the plan and records the purchase.

## Connecting a Payment Provider[​](#connecting-a-payment-provider "Direct link to Connecting a Payment Provider")

Go to **Organization Settings → Payment Providers** to see all available providers and their current status.

To connect a provider:

1. Click **Connect** next to the provider you want to set up.
2. You are redirected to the provider's site to authorize the connection. Sign in if prompted.
3. Grant the requested permissions and confirm the connection.
4. You are redirected back to Allegro. The provider's panel updates to show **Connected**.

note

Only one payment provider can be active at a time. If you need to switch providers, disconnect the current one first.

## Verifying the Connection[​](#verifying-the-connection "Direct link to Verifying the Connection")

Once connected, the provider panel shows the account name and whether charges and payouts are currently enabled on that account. If charges are not enabled, check your account status with the provider directly — additional verification steps may be required.

## Disconnecting a Provider[​](#disconnecting-a-provider "Direct link to Disconnecting a Provider")

To disconnect:

1. Go to **Organization Settings → Payment Providers**.
2. Click **Disconnect** next to the active provider.
3. Confirm the action.

After disconnecting, paid plans in your offers will no longer initiate checkout. Existing entitlements granted through previous purchases are not affected.

warning

Disconnecting immediately disables payment processing. Any member who attempts to purchase a paid plan will see an error until a payment provider is reconnected.

## Webhooks[​](#webhooks "Direct link to Webhooks")

Reliable checkout fulfillment depends on webhook notifications from your payment provider. Without a webhook configured, purchases are only recorded when the member is redirected back to your site after checkout — they are missed if the member closes the browser before being redirected.

Contact your platform administrator to confirm the webhook is configured for your Allegro instance.

## Related[​](#related "Direct link to Related")

* [Offers and Plans](/product/entitlements/offers.md) — Configure paid plans that trigger checkout
* [Entitlements](/product/entitlements.md) — What members receive after a successful purchase
* [One-off Purchases](/developer/guides/payment/purchases.md) — Initiating checkout from the SDK