Prerequisites
- Paid subscription (not available on free plan)
- A payment provider account: PayPal, Stripe, or Razorpay
- Recommended: a custom domain + SSL (especially for live payments)
How to access
Navigate to Dashboard → [Your Website] → Accept Payments.Supported payment methods
You can configure:- PayPal
- Stripe
- Razorpay
- You can save credentials for multiple providers, but only one payment method can be active at a time.
PayPal setup
One-time payments (basic)
- Expand PayPal.
- Enter your PayPal account Email.
- Click Save.
- Click Activate.
Recurring payments (advanced)
If you enable recurring payments, you’ll need API credentials from PayPal Developer.- Enable recurring payments.
- Get your Client ID and Secret Key from PayPal Developer (Live mode).
- Paste credentials into the dashboard fields.
- Click Save, then Activate.
Stripe setup
Get your Stripe secret key
- Go to Stripe Dashboard
- Developers → API keys
- Copy your Secret key (use Live keys for real payments)
Configure in Butternut
- Expand Stripe.
- Paste the Secret key.
- Click Save, then Activate.
Razorpay setup
Get your Razorpay credentials
- Go to Razorpay Dashboard
- Settings → API Keys
- Copy Key ID and Key Secret
Configure in Butternut
- Expand Razorpay.
- Enter Key ID and Key Secret.
- Click Save, then Activate.
Save vs Activate
- Save stores credentials but does not enable payments.
- Activate makes the method live and deactivates any other method.
- Enter credentials
- Save
- Activate
- Test a transaction
Security notes
- Never share or publish secret keys.
- Don’t use test keys in production.
- Rotate keys if you suspect compromise.
Troubleshooting
“Unable to activate payment method”
- Check credentials are correct (no extra spaces).
- Confirm the provider account is in live mode and fully set up.
- Verify SSL is enabled on your site.
Payments not working on the website
- Confirm the method shows Activated.
- Confirm domain + SSL are active.
- Check provider dashboards for errors.
Version: 1.0