Connecting Payment Gateways

TL;DR: Connect your preferred payment gateway to enable online fee payments. EduSuite OS supports Razorpay, Stripe, PayU, GCash, Maya, and more. Setup takes 10-15 minutes once you have your gateway credentials.

Supported Gateways

Gateway	Regions	Payment Methods
Razorpay	India	UPI, Cards, Net Banking, Wallets
Stripe	Global (135+ countries)	Cards, Apple Pay, Google Pay
PayU	India, SE Asia	UPI, Cards, Net Banking
GCash	Philippines	GCash Wallet
Maya	Philippines	Maya Wallet, Cards
PayPal	Global	PayPal, Cards

Step 1: Get Gateway Credentials

Razorpay (India)

Sign up at razorpay.com.
Complete KYC verification (takes 1-2 business days).
From Dashboard → Settings → API Keys, generate:
- Key ID (starts with rzp_live_)
- Key Secret

Stripe (Global)

Sign up at stripe.com.
Verify your identity and bank account.
From Dashboard → Developers → API Keys, copy:
- Publishable Key (starts with pk_live_)
- Secret Key (starts with sk_live_)

Step 2: Configure in EduSuite OS

Go to Settings → Finance → Payment Gateway.
Click + Add Gateway.
Select your gateway provider.
Enter your credentials:
- API Key / Key ID
- API Secret / Key Secret
- Webhook Secret (if applicable)
Choose the mode:
- Test Mode — For testing with dummy cards (use first!)
- Live Mode — Real payments
Click Save & Test Connection.

Step 3: Test the Integration

Keep the gateway in Test Mode.
Go to any student's fee page.
Click Pay Online and complete a test payment.
Verify the transaction appears in:
- EduSuite OS: Finance → Transactions
- Gateway dashboard: Razorpay/Stripe dashboard
Once verified, switch to Live Mode.

Test Card Numbers

Gateway	Test Card	CVV	Expiry
Razorpay	4111 1111 1111 1111	Any 3 digits	Any future date
Stripe	4242 4242 4242 4242	Any 3 digits	Any future date

Step 4: Configure Webhooks

Webhooks ensure EduSuite OS receives real-time payment confirmations:

In your gateway dashboard, go to Webhooks settings.
Add this URL: https://yourschool.edusuiteos.in/api/webhooks/payment
Select events to listen for:
- payment.captured (Razorpay)
- checkout.session.completed (Stripe)
- payment.failed
- refund.processed
Copy the Webhook Secret and paste it in EduSuite OS's gateway settings.

Step 5: Transaction Fees

Understand gateway charges:

Gateway	Transaction Fee	Settlement Time
Razorpay	2% per transaction	T+2 days
Stripe	2.9% + ₹2 / $0.30	T+2 days
PayU	1.9% per transaction	T+3 days
GCash	2.5% per transaction	T+1 day

Info

These fees are charged by the gateway, not EduSuite OS. You can choose to absorb them or pass them to parents as a "convenience fee."

Convenience Fee Setup

To pass gateway charges to parents:

Go to Settings → Finance → Payment Gateway → Fees.
Enable "Add Convenience Fee".
Set the fee type:
- Percentage — e.g., 2.5% of payment amount
- Fixed — e.g., ₹25 / $1 per transaction
Parents will see the convenience fee during checkout.

Multiple Gateways

You can configure multiple gateways simultaneously:

Parents can choose their preferred payment method at checkout.
Set a primary gateway for auto-debit and default payments.
Different gateways for different regions (useful for international schools).

Troubleshooting

Q: "Payment failed" but money was deducted. A: The payment is likely in a pending state at the gateway. Check the gateway dashboard. Most auto-refund within 5-7 business days.

Q: Webhook not receiving events. A: Verify the webhook URL is correct and publicly accessible. Check your gateway's webhook logs for delivery attempts and errors.

Q: Test mode works but live mode fails. A: Ensure you're using live API keys (not test keys). Verify KYC is complete on your gateway account.

Q: Can parents pay using UPI? A: Yes, if using Razorpay or PayU. UPI is automatically available as a payment option for Indian parents.

Need help choosing a payment gateway for your region? Talk to our team.

Connecting Payment Gateways (Razorpay, Stripe, GCash)