Configuration Best Practices

Complete guide for Configuration Best Practices

Security Guidelines

API Key Management:
  • Use test keys during development
  • Switch to live keys only after thorough testing
  • Never commit API keys to version control
  • Rotate keys regularly for security
  • Use environment variables for production
Webhook Security:
  • Always verify webhook signatures
  • Use HTTPS endpoints only
  • Implement webhook retry logic
  • Monitor webhook delivery status
  • Set up webhook failure alerts

Testing Procedures

Test Mode Setup:
  1. Enable Sandbox/Test Mode in Schedula
  1. Use test API keys from payment gateway
  1. Make test transactions with test cards
  1. Verify webhook notifications
  1. Test both successful and failed payments
Test Cards (Stripe):
  • Success4242424242424242
  • Decline4000000000000002
  • 3D Secure4000002500003155
Test Cards (Razorpay):
  • Success4111111111111111
  • Decline4000000000000002
  • UPI: Use any valid UPI ID

Production Deployment

Pre-Launch Checklist:
  • [ ] Switch to live API keys
  • [ ] Disable test mode
  • [ ] Verify webhook endpoints
  • [ ] Test with real payment methods
  • [ ] Configure monitoring and alerts
  • [ ] Set up error logging
  • [ ] Test refund and dispute handling
Monitoring Setup:
  • Monitor payment success rates
  • Track webhook delivery status
  • Set up alerts for failed payments
  • Monitor API response times
  • Track transaction volumes

Troubleshooting

Common Issues:
Payment Declined:
  • Verify API keys are correct
  • Check if test mode is enabled/disabled appropriately
  • Ensure currency matches your account settings
  • Verify card details are correct
Webhook Notifications:
  • Check webhook URL is accessible
  • Verify webhook secret is correct
  • Ensure HTTPS is used for production
  • Check webhook event selection
Connection Errors:
  • Verify API keys are valid
  • Check internet connectivity
  • Ensure firewall allows API calls
  • Verify account is active and verified
This comprehensive documentation covers all aspects of configuring Stripe and Razorpay payment gateways in Schedula, ensuring secure and reliable payment processing for your appointment booking system.
×