Skip to Content
👋 New here and not sure where to start? Follow the How to start guide →
Payment ProcessorCreate payment processor

Create Payment Processor

Step-by-step guide to creating and configuring a payment processor for handling payments in your application.

What is a payment processor? It’s an intermediary between your application and payment systems (Stripe/Paddle) that processes transactions and manages subscriptions. Read mode

Step 1: Creating a New Payment Processor

Navigate to the “Payment Processors” section and click the “New Payment Processor” button.

Create payment processor

Step 2: Choose Payment System

Select one of the supported payment systems:

Stripe Popular payment system with wide support for cards and payment methods. Advantages: - Support for most bank cards - Global coverage - Simple integration - Detailed analytics Best for: - International projects - SaaS applications - Web services

Step 3: Choose Operation Mode

Configure the payment processor operation mode:

ModeDescriptionUsage
TestMode for development and testingDevelopment, debugging, testing
Live (Production)Mode for real paymentsProduction application

Important! Always start with test mode. After configuring and testing all functions, you can switch to production mode.

Step 4: Payment Processor Configuration

If you chose Stripe, you need to configure API keys:

You can find API keys in the Stripe dashboard  (for test mode: test keys )

Required data for Stripe:

FieldDescriptionFormat
Publishable KeyPublic key for client-sidepk_test_... or pk_live_...
Secret KeySecret key for server-sidesk_test_... or sk_live_...

Security: Never expose the secret key. It should only be used on the server.

Additional Stripe settings:

  • Customer Portal: Configure customer portal in Stripe settings 
  • Webhooks: The system will automatically create a webhook for event processing

Step 5: Save

After filling in all fields:

  1. Key validation: The system will automatically verify the correctness of API keys
  2. Webhook creation: A webhook for event processing will be created automatically
  3. Activation: The processor will be activated and ready to use

Troubleshooting

Stripe key validation error

Check: - Correctness of copied keys - Key compliance with selected mode (test/live) - Access permissions in Stripe account

Paddle key validation error

Make sure that: - API Key is created with “Never Expires” and full permissions - Vendor ID contains only numbers - You’re using the correct environment (sandbox/production)

Freemius key validation error

Make sure that: - You copied the developer keys from My Profile → Keys, not the keys of a single product - Developer ID contains only numbers - The public key starts with pk_ and the secret key with sk_

Freemius prices are not synced

Open the paywall’s payment processor manager and press Sync prices now to see the exact error. Common causes: - The paywall has only weekly prices, which Freemius can’t sell - A local price is outside the range Freemius allows for that currency - The product was deleted in Freemius or belongs to another Freemius developer account

Next Steps

After creating the payment processor:

Best Practices

  1. Security: Never store API keys in plain text
  2. Testing: Always test payments before going live