How do I switch to a different payment gateway?

Run the setup wizard again from your account menu ('Run Setup'). On the gateway step, disconnect your current gateway and select a new one. Your cancel flow configuration is preserved — only the gateway connection changes. You'll need to re-map any plan-specific offers to match the new gateway's plan IDs.

What permissions does SubJolt need from my gateway?

SubJolt needs read access to subscriptions and customers, plus write access to apply discounts, pauses, and plan changes. For Stripe and Shopify, these scopes are requested during OAuth. For Chargebee, Recharge, and Recurly, use a full-access API key or one with subscription read/write permissions.

What happens if my gateway connection expires?

For OAuth gateways (Stripe, Shopify), connections can break if you revoke access from your gateway's dashboard. For API key gateways (Chargebee, Recharge, Recurly), connections fail if the key is rotated or deleted. In either case, re-run the setup wizard to reconnect with fresh credentials.

Do all gateways support the same save actions?

All five gateways support discounts, subscription pauses, plan changes, and cancellations. The specific API calls vary by gateway, but SubJolt handles the differences internally — the subscriber experience is the same regardless of which gateway you use.

Help Center/Payment Gateways

Payment Gateways

Connect your payment gateway to automate retention offers. SubJolt handles discounts, pauses, and plan changes for you.

Connecting a payment gateway lets SubJolt execute save actions automatically — applying discounts, pausing subscriptions, and switching plans without manual work. It also enables subscriber identification and reactivation banners, since both require reading subscription status from your gateway. All five supported gateways can handle discounts, pauses, and plan changes. The connection method varies: Stripe and Shopify use OAuth (you authorize in a popup), while Chargebee, Recharge, and Recurly use API keys (you paste the key during setup).

Stripe

OAuth

Stripe connects via OAuth, giving SubJolt scoped access to your subscriptions without exposing your secret key. Once connected, SubJolt can apply coupon discounts, pause subscription collection, switch plans, and cancel subscriptions. Stripe's OAuth tokens are long-lived but can be revoked from your Stripe dashboard. If you revoke access, re-run the SubJolt setup wizard to reconnect.

How to connect

Run the setup wizard and select Stripe as your gateway
Click Connect — you'll be redirected to Stripe's OAuth authorization page
Authorize SubJolt to access your Stripe account
SubJolt will automatically detect your plans and pricing
Verify the connection by checking that your plans appear in the settings editor

Shopify

OAuth

Shopify connects via OAuth to manage subscription contracts in your store. SubJolt can apply discounts, pause subscriptions, and update contracts. This integration works with Shopify's native subscriptions and third-party subscription apps that use Shopify's subscription contract API. If you revoke the app's access from your Shopify admin, re-run setup to reconnect.

How to connect

Run the setup wizard and select Shopify as your gateway
Click Connect — you'll be redirected to Shopify's OAuth authorization page
Authorize SubJolt to access your store's subscription data
SubJolt will import your subscription products and plans
Verify the connection by checking that your plans appear in the settings editor

Chargebee

API Key

Chargebee connects with an API key and your Chargebee site name. SubJolt can apply coupon discounts, pause subscriptions, change plans, and cancel subscriptions through Chargebee's API. Generate a full-access API key from your Chargebee dashboard under Settings → API Keys. The key and site name are stored server-side and never exposed to client-side code.

How to connect

Run the setup wizard and select Chargebee as your gateway
Enter your Chargebee site name (the subdomain from your Chargebee URL)
Enter your Chargebee API key (full-access key from Settings → API Keys)
SubJolt will validate the connection and detect your plans
Verify the connection by checking that your plans appear in the settings editor

Recharge

API Key

Recharge connects with an API key for subscription management. SubJolt can apply discounts, skip or pause upcoming charges, and update subscription details through Recharge's API. Generate an API token from your Recharge dashboard under the API tokens section with read and write scopes for subscriptions and customers. The key is stored server-side and never exposed to client-side code.

How to connect

Run the setup wizard and select Recharge as your gateway
Enter your Recharge API key (from the API tokens section in your Recharge dashboard)
SubJolt will validate the connection and access your subscriptions
Verify the connection by checking that your subscription data appears in the settings editor

Recurly

API Key

Recurly connects with an API key for subscription management. SubJolt can apply coupon discounts, pause billing, change plans, and cancel subscriptions through Recurly's API. Generate a private API key from your Recurly dashboard under Integrations → API Credentials. The key is stored server-side and never exposed to client-side code.

How to connect

Run the setup wizard and select Recurly as your gateway
Enter your Recurly API key (from Integrations → API Credentials in your Recurly dashboard)
SubJolt will validate the connection and detect your plans
Verify the connection by checking that your plans appear in the settings editor

Payment Gateway FAQ

Ready to connect your gateway?

Set up automated retention offers in minutes.

Start Free