Payment Gateway Integration
Payment gateway integration in EquiBillBook allows you to accept online payments from customers through various payment methods. This guide explains how to integrate and configure payment gateways effectively.
What is Payment Gateway Integration?
Payment gateway integration connects EquiBillBook with payment processing services that handle online transactions. This enables customers to pay invoices, make bookings, and complete purchases directly through payment links, without manual payment processing.
Benefits of Payment Gateway Integration
Integrating payment gateways provides:
- Faster Payments: Customers can pay instantly online
- Multiple Payment Methods: Accept cards, UPI, net banking, wallets
- Automated Processing: Payments are automatically recorded
- Reduced Manual Work: Less manual payment entry and reconciliation
- Better Cash Flow: Faster payment collection
- Payment Tracking: Real-time payment status tracking
Supported Payment Gateways
EquiBillBook supports various payment gateways:
- Razorpay: Popular payment gateway for India
- Stripe: Global payment processing platform
- PayPal: International payment service
- PayU: Payment gateway for multiple countries
- CCAvenue: Payment gateway for India
- Instamojo: Payment gateway for India
- Custom Gateway: Integrate your own payment gateway
Accessing Payment Gateway Integration
To access payment gateway integration:
- Navigate to Settings → Online Payment Settings → Payment Gateway Integration
- View available payment gateways
- Select payment gateway to integrate
- Configure gateway settings
- Test integration
Razorpay Integration
To integrate Razorpay:
- Create Razorpay account at razorpay.com
- Get API Key and API Secret from Razorpay dashboard
- In EquiBillBook, select Razorpay as payment gateway
- Enter API Key
- Enter API Secret
- Configure webhook URL
- Test payment processing
- Save configuration
Stripe Integration
To integrate Stripe:
- Create Stripe account at stripe.com
- Get Publishable Key and Secret Key from Stripe dashboard
- In EquiBillBook, select Stripe as payment gateway
- Enter Publishable Key
- Enter Secret Key
- Configure webhook endpoint
- Test payment processing
- Save configuration
PayPal Integration
To integrate PayPal:
- Create PayPal Business account
- Get Client ID and Secret from PayPal Developer dashboard
- In EquiBillBook, select PayPal as payment gateway
- Enter Client ID
- Enter Secret
- Select environment (Sandbox for testing, Live for production)
- Test payment processing
- Save configuration
Payment Gateway Configuration
Common configuration settings:
- Gateway Selection: Choose payment gateway provider
- API Credentials: Enter API keys, secrets, tokens
- Environment: Sandbox (test) or Production (live)
- Webhook URL: URL for receiving payment status updates
- Webhook Secret: Secret for webhook verification
- Currency: Default currency for payments
- Test Mode: Enable test mode for testing
Payment Gateway Testing
Test payment gateway integration:
- Enable test/sandbox mode
- Create test payment link
- Process test payment
- Verify payment is recorded correctly
- Check webhook receives status updates
- Test different payment methods
- Test error scenarios
- Switch to production mode when ready
Webhook Configuration
Configure webhooks for payment status updates:
- Webhook URL: Public URL to receive payment events
- Webhook Secret: Secret for verifying webhook requests
- Webhook Events: Select events to receive (payment success, failure, refund)
- Webhook Verification: Verify webhook with gateway
- SSL Required: Webhook URL must use HTTPS
Payment Methods Supported
Different gateways support different payment methods:
- Credit/Debit Cards: Visa, Mastercard, Amex, RuPay
- UPI: Unified Payments Interface (India)
- Net Banking: Online banking transfers
- Wallets: Digital wallets (Paytm, PhonePe, etc.)
- Bank Transfer: Direct bank transfers
- Buy Now Pay Later: EMI, BNPL options
Payment Gateway Security
Important security considerations:
- Secure Credentials: Protect API keys and secrets
- HTTPS Only: Use HTTPS for all payment communications
- PCI Compliance: Ensure PCI DSS compliance
- Webhook Verification: Always verify webhook requests
- Access Control: Limit access to gateway settings
- Regular Updates: Keep gateway integration updated
Payment Gateway Fees
Understand payment gateway fees:
- Transaction Fees: Percentage or fixed fee per transaction
- Setup Fees: One-time setup charges (if any)
- Monthly Fees: Monthly subscription fees (if any)
- Refund Fees: Fees for processing refunds
- International Fees: Additional fees for international payments
- Fee Structure: Review fee structure before integrating
Multiple Gateway Support
Configure multiple payment gateways:
- Set up multiple gateways for redundancy
- Allow customers to choose gateway
- Automatically switch to backup if primary fails
- Route payments based on amount or method
Payment Gateway Logs
Monitor payment gateway activity:
- View payment processing logs
- Check transaction status
- Review failed transactions
- Monitor API errors
- Track payment success rates
- Analyze payment patterns
Troubleshooting Payment Gateway
Common issues and solutions:
- Connection Failed: Check API credentials and network
- Authentication Failed: Verify API keys are correct
- Payment Not Processing: Check gateway status and configuration
- Webhook Not Receiving: Verify webhook URL and SSL
- Payment Not Recorded: Check webhook configuration
- Currency Mismatch: Ensure currency settings match
- Test Mode Issues: Verify test credentials are used in test mode
Payment Gateway Best Practices
- Choose Reliable Gateway: Select reputable payment gateway
- Test Thoroughly: Test integration before going live
- Monitor Regularly: Monitor payment processing regularly
- Keep Credentials Secure: Protect API keys
- Handle Errors: Implement proper error handling
- Provide Support: Help customers with payment issues
- Stay Updated: Keep gateway integration updated
Payment Gateway Compliance
Important compliance requirements:
- PCI DSS: Ensure PCI compliance for card payments
- Data Protection: Protect customer payment data
- Regulations: Comply with local payment regulations
- Terms of Service: Follow gateway terms of service
- Privacy Policy: Maintain privacy policy for payment data
Properly integrated payment gateways enable seamless online payment collection, improving cash flow and customer experience. Choose a reliable gateway, configure correctly, test thoroughly, and monitor regularly.