Skip to main content

Payment Provider

A payment provider handles the checkout flow for paid Offers. 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​

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.
Not every provider runs checkout

Some providers only record payments taken somewhere else, rather than running Allegro's hosted checkout. While a provider like that is your active one, paid plans can't start a checkout in Allegro — the purchases still show up, but you collect payment through the provider's own flow.

Connecting a Payment Provider​

Go to Organization Settings → Payment Providers to see every available provider. Each one shows its name, whether it supports Allegro checkout, how it connects, and whether it is currently connected.

Providers connect in one of two ways:

Providers Allegro connects for you. These authorize through the provider's own sign-in:

  1. Click Connect next to the provider.
  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, and the provider shows Connected.

Providers you set up on their own settings page. These are configured elsewhere in Allegro first:

  1. Click Set up {provider} to open that provider's settings page and enter its credentials there.
  2. Return to Payment Providers and click Use {provider} to make it your active provider.
note

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

Some providers require a package

A provider may only appear in the list once the package that supplies it is enabled under Organization Settings → Packages.

Verifying the Connection​

Once connected, the provider panel shows the account name, and — for providers that report them — 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​

How you turn a provider off depends on how it connected:

  • For a provider Allegro connected for you, click Disconnect. This removes the stored credentials and stops payments.
  • For a provider you set up on its own settings page, click Stop using {provider}. This stops Allegro from using it, but leaves its credentials in place on that provider's settings page, so you can switch back with Use {provider} later.

Confirm the action when prompted. Existing entitlements granted through previous purchases are not affected.

warning

Turning off your active checkout provider immediately disables payment processing. Any member who attempts to purchase a paid plan will see an error until a checkout-capable provider is active again.

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.