Payment Gateways

Payment gateways let your customers pay for subscription plans. Configure them in Admin → Clients & Billing → Payment Gateways — enable only the ones you have accounts for; customers see enabled gateways at checkout.

Gateway configuration — credentials are stored encrypted.

Supported gateways

Common setup pattern

Every gateway follows the same three steps:

1. Credentials — copy the API keys from the gateway's dashboard into the gateway's card in Admin → Payment Gateways. Each gateway has a test/sandbox mode toggle — start there.

2. Webhook — register WhatsMax's webhook URL in the gateway dashboard so payment events (successful charge, failed renewal, refund) reach the platform:

   https://your-domain/api/webhooks/{gateway}
   

   Replace {gateway} with the gateway key shown on its configuration card (e.g. stripe, paypal, razorpay).

3. Test checkout — register a test customer account, subscribe to a paid plan with the gateway's test cards, and confirm the subscription shows as active in Admin → Subscriptions and the payment in Admin → Payments.

Stripe example (end to end)

1. In the Stripe dashboard → Developers → API keys, copy the Publishable key and Secret key (test mode first).
2. Paste both into the Stripe card in Admin → Payment Gateways and enable it.
3. In Stripe → Developers → Webhooks → Add endpoint, set the URL to https://your-domain/api/webhooks/stripe and subscribe to payment/subscription events (checkout.session.completed, invoice.paid, invoice.payment_failed, customer.subscription.updated, customer.subscription.deleted).
4. Copy the webhook Signing secret into the Stripe gateway card.
5. Run a test subscription with card 4242 4242 4242 4242.
6. When everything works, repeat with live keys and switch off test mode.

Renewals, failures and refunds

• Subscription renewals are driven by gateway webhooks; the scheduler also runs periodic reconciliation. Keep both the worker and scheduler processes running.
• Failed renewals move the subscription into a past-due/grace state visible in Admin → Subscriptions.
• Refunds issued in the gateway dashboard flow back via webhook and appear on the payment record.