Skip to Content
Payment ProcessorConnect payment processor to paywall

Connect Payment Processor to Paywall

Learn how to connect payment processors to your paywalls to enable transaction processing and handle payments effectively.

Prerequisites: To go live you need at least one payment processor of your own. To test, you don’t need one at all — every account gets two sandbox processors ready to connect.

Overview

Connecting payment processors to paywalls allows you to:

  • Process transactions through multiple payment providers
  • Distribute risk across different payment systems

Step 1: Access Payment Processor Manager

Navigate to your paywall settings and locate the “Payment Processor Manager” button. This is where you can manage which payment processors are connected to your specific paywall.

Connect payment processor

Step 2: Understanding Test vs Live Mode

The system automatically shows payment processors based on your paywall’s current mode:

Paywall ModeAvailable ProcessorsUsage
Test ModeYour test processors + our two sandbox processorsDevelopment and testing
Live ModeOnly live payment processorsProduction environment

Important: Test payment processors connected will only be available when the paywall is in test mode. When you switch paywall to live mode, only live connected payment processors will be available for clients.

Step 3: Select Payment Processors

Choose which payment processors you want to connect to your paywall:

  1. Open the Payment Processor Manager modal
  2. Review available processors - The Test tab lists your own test processors plus our two sandbox processors; the Live tab lists your live processors
  3. Select processors - Use checkboxes to select which ones to connect
  4. Review processor information:
    • Name - Custom name you assigned
    • Mode - Test or Live indicator
    • Provider - Stripe, Paddle, etc.

No processor of your own yet? The Test tab always contains our two sandbox processors, so you can connect one and test the full payment flow before you open a Stripe or Paddle account. See Test with our sandbox processors.

Risk Distribution: You can select multiple payment processors and set the traffic share for each one, or use Distribute equally to split traffic evenly. Shares are configured per mode independently (Test vs Live).

Step 4: Save Configuration

After selecting your payment processors:

  1. Click “Save” to apply the configuration
  2. Wait for confirmation - The system will update the connections

Payment Processing Logic

When multiple payment processors are connected:

Load Distribution: Transactions are automatically distributed equally between all connected payment processors. This helps balance load and reduce dependency on a single provider.

Transaction Flow

  1. Customer initiates payment
  2. System selects processor - Automatically chooses from connected processors
  3. Payment processing - Transaction is handled by selected processor
  4. Confirmation - Payment success/failure is reported back

Removing Processors

To remove payment processors:

  1. Uncheck the processors you want to disconnect
  2. Save the configuration
  3. Removed processors will no longer process new transactions

Active Transactions: Removing a payment processor doesn’t affect ongoing transactions or existing subscriptions. Only new transactions will use the updated processor list.

Troubleshooting

No payment processors available

Possible causes:

  • No payment processors created in the current mode
  • All processors are in different mode (test vs live)
  • Processors are not properly configured

Solution:

  • In the Test tab you always have our two sandbox processors available, even with no processors of your own
  • For Live, create a payment processor in live mode
  • Verify processor configuration and status in the main dashboard
Cannot select a processor

A processor is greyed out and cannot be ticked when it is managed by the platform — its caption reads “Managed processor — contact support to edit”. These belong to us rather than to your account, so you can’t connect or edit them yourself.

This does not apply to our sandbox processors (“Our sandbox processor — payments are simulated…”). Those are selectable by any account — see Test with our sandbox processors.

Solution:

  • Contact support if you believe you should have access to a managed processor
  • For your own processors, verify credentials and webhook setup
Payments not processing

Possible causes:

  • No processors connected to paywall
  • Configuration errors in payment processors

Solution:

  • Ensure at least one processor is connected
  • Verify processor status and credentials
  • Review processor logs for errors

Best Practices

Redundancy and Reliability

  1. Multiple Processors - Connect at least 2 payment processors for redundancy
  2. Different Providers - Use different payment systems (e.g., Stripe + Paddle)
  3. Monitor Performance - Track success rates for each processor

Next Steps

After connecting payment processors to your paywall:

Configure WebhooksTest PaymentsMonitor Transactions

API Reference

For programmatic management of payment processor connections, see:

Create payment processorOverview