Appearance

Payment Gateways ​

Payment gateways handle the actual processing of customer payments. BadgerPanel supports Stripe and PayPal out of the box.

Gateway Settings Page ​

Navigate to Admin > Billing > Settings > Payment Gateways to manage your payment providers. You can enable one or both gateways. Customers will see all enabled gateways as options during checkout.

Stripe Setup ​

Stripe is the recommended gateway for card payments, supporting credit cards, debit cards, and various regional payment methods.

Configuration ​

  1. Navigate to Admin > Billing > Settings > Payment Gateways.
  2. Enable Stripe.
  3. Enter your Secret Key (starts with sk_live_ or sk_test_).
  4. Enter your Publishable Key (starts with pk_live_ or pk_test_).
  5. Click Save.

Webhook Setup ​

Stripe webhooks allow the panel to receive real-time payment notifications (successful charges, refunds, disputes, etc.).

  1. In your Stripe Dashboard, navigate to Developers > Webhooks.
  2. Click Add Endpoint.
  3. Set the endpoint URL to:
    https://panel.example.com/api/billing/webhooks/stripe
    Replace panel.example.com with your actual panel domain.
  4. Select the events to listen for. At minimum, enable:
    • checkout.session.completed
    • invoice.paid
    • invoice.payment_failed
    • customer.subscription.deleted
  5. Copy the Webhook Signing Secret (starts with whsec_) and enter it in the panel's Stripe settings.
  6. Click Save in both the Stripe Dashboard and the panel.

Stripe Test Mode ​

Use Stripe test keys (prefixed with sk_test_ and pk_test_) to process test payments without real charges. Stripe provides test card numbers for simulating different scenarios.

PayPal Setup ​

PayPal allows customers to pay using their PayPal balance, linked bank accounts, or cards through PayPal's checkout flow.

Configuration ​

  1. Navigate to Admin > Billing > Settings > Payment Gateways.
  2. Enable PayPal.
  3. Enter your Client ID.
  4. Enter your Client Secret.
  5. Click Save.

Obtaining PayPal API Credentials ​

  1. Log in to the PayPal Developer Dashboard.
  2. Navigate to Apps & Credentials.
  3. Create a new app or select an existing one.
  4. Copy the Client ID and Client Secret from the app details.
  5. For production payments, make sure you are viewing Live credentials, not Sandbox.

Testing Payments ​

Before going live, verify your gateway configuration with test transactions:

  1. Configure your gateway with test/sandbox credentials.
  2. Create a simple product with a low price.
  3. Place a test order as a customer.
  4. Complete the checkout with test payment details.
  5. Confirm that the order status updates to Paid and the server is provisioned (if auto-activate is enabled).
  6. Check that the webhook is delivering events correctly by reviewing the webhook logs in your Stripe or PayPal dashboard.

Once testing is complete, replace your test credentials with live production credentials and save.

Next Steps ​

BadgerPanel Documentation

Copyright 2024-present BadgerPanel