​

Changelog

​

Version 2.1.0 - January 15, 2024

​

✨ New Features

• Apple Pay Support: Added native Apple Pay integration for H2H payments
• Enhanced 3D Secure: Improved 3DS 2.0 support with better authentication flows
• Webhook Retry Logic: Configurable retry policies for webhook deliveries

​

🔧 Improvements

• Response Times: 25% improvement in API response times
• Error Messages: More descriptive error messages with actionable guidance
• Documentation: Comprehensive guides and interactive API explorer

​

🐛 Bug Fixes

• Fixed UPI timeout handling for slow network conditions
• Resolved webhook signature verification edge cases
• Corrected currency validation for multi-currency transactions

​

Version 2.0.0 - December 1, 2023

​

🚨 Breaking Changes

• API Versioning: Introduced versioning in API endpoints
• Authentication: Migrated from Bearer tokens to X-API-Key header
• Webhook Format: Updated webhook payload structure

​

Migration Guide

// Old authentication (deprecated)
headers: {
  'Authorization': 'Bearer your_token'
}

// New authentication (required)
headers: {
  'X-API-Key': 'your_api_key'
}

​

✨ New Features

• Google Pay Integration: Full Google Pay support for web and mobile
• Multi-Currency Support: Process payments in 20+ currencies
• Advanced Fraud Detection: Enhanced security with machine learning

​

🔧 Improvements

• Rate Limiting: Increased limits for production accounts
• Monitoring: Real-time transaction monitoring dashboard
• SDKs: Updated JavaScript and Python SDKs

​

Version 1.5.2 - October 20, 2023

​

🐛 Bug Fixes

• Fixed intermittent timeout issues with UPI payments
• Resolved webhook delivery delays during high traffic
• Corrected amount validation for zero-decimal currencies

​

🔧 Improvements

• Performance: Reduced payment processing latency by 15%
• Logging: Enhanced request/response logging for debugging

​

Version 1.5.1 - September 15, 2023

​

🔧 Improvements

• UPI Enhancements: Better error handling for UPI transactions
• Webhook Reliability: Improved webhook delivery success rate
• Documentation: Added more code examples and use cases

​

🐛 Bug Fixes

• Fixed edge case in credit card validation
• Resolved timezone issues in webhook timestamps

​

Version 1.5.0 - August 10, 2023

​

✨ New Features

• UPI Integration: Added support for UPI payments in India
• QR Code Payments: Generate QR codes for mobile payments
• Sandbox Enhancements: Improved testing environment with more scenarios

​

🔧 Improvements

• Error Handling: Standardized error response format
• Security: Enhanced API key validation and rotation
• Performance: Optimized database queries for faster responses

​

Version 1.4.0 - June 25, 2023

​

✨ New Features

• Alternative Payments: Support for bank transfers and BNPL options
• Webhook Signatures: HMAC SHA512 signature verification
• Payment Status Polling: Real-time status updates

​

🔧 Improvements

• API Documentation: Interactive OpenAPI specification
• Testing: Comprehensive test card suite
• Monitoring: Enhanced error tracking and alerting

​

Version 1.3.0 - May 5, 2023

​

✨ New Features

• 3D Secure Support: Full 3DS authentication flow
• Refund API: Programmatic refund processing
• Batch Operations: Process multiple payments efficiently

​

🐛 Bug Fixes

• Fixed currency conversion edge cases
• Resolved webhook duplicate delivery issues

​

Version 1.2.0 - March 20, 2023

​

✨ New Features

• Multi-Gateway Support: Route payments through multiple processors
• Risk Management: Advanced fraud detection rules
• Reporting API: Transaction reporting and analytics

​

🔧 Improvements

• Rate Limiting: Implemented fair usage policies
• Caching: Improved response times with intelligent caching

​

Version 1.1.0 - February 1, 2023

​

✨ New Features

• Webhook Notifications: Real-time payment status updates
• Payment Methods: Expanded credit card support
• Sandbox Environment: Dedicated testing environment

​

🔧 Improvements

• Error Messages: More descriptive error responses
• Validation: Enhanced input validation and sanitization

​

Version 1.0.0 - January 10, 2023

​

🎉 Initial Release

• Core Payment Processing: Credit card payment support
• REST API: RESTful API design with JSON responses
• Security: PCI DSS compliant payment processing
• Documentation: Comprehensive API documentation

​

Deprecation Policy

​

Timeline

• Announcement: 90 days notice for breaking changes
• Deprecation: 6 months support for deprecated features
• Removal: Complete removal after deprecation period

​

Communication

• Email Notifications: Sent to registered developer emails
• API Headers: Deprecation warnings in API responses
• Documentation: Clear migration guides and timelines

​

Current Deprecations

​

Bearer Token Authentication (Deprecated)

• Deprecated: December 1, 2023
• Removal: June 1, 2024
• Migration: Use X-API-Key header instead

// Deprecated (will be removed June 2024)
headers: {
  'Authorization': 'Bearer your_token'
}

// Current (use this)
headers: {
  'X-API-Key': 'your_api_key'
}

​

Version Support

​

Breaking Changes Guide

​

How We Handle Breaking Changes

1. Advance Notice: 90 days minimum notice
2. Migration Period: 6 months overlap support
3. Documentation: Detailed migration guides
4. Support: Dedicated migration assistance

​

What Constitutes a Breaking Change

• Removing API endpoints
• Changing required parameters
• Modifying response structure
• Authentication method changes
• Webhook payload changes

​

Non-Breaking Changes

• Adding optional parameters
• Adding new response fields
• New API endpoints
• Performance improvements
• Bug fixes

​

Staying Updated

​

Notification Channels

• Email: Subscribe to developer updates
• Webhook: api.version.deprecated event
• Documentation: Version-specific documentation
• Status Page: System updates and maintenance

​

API Versioning

# Specify API version in requests
curl -X POST https://api.cyrexa.com/v2/payments/h2h/1 \
  -H "X-API-Key: your_key" \
  -H "X-API-Version: 2.1"

​

Backward Compatibility

• v2.x: All 2.x versions are compatible
• v1.x: Legacy support until March 2024

​

Migration Assistance

​

Resources Available

• Migration Guides: Step-by-step instructions
• Code Examples: Before/after code samples
• Testing Tools: Validate your migration
• Support Team: Technical assistance

​

Contact for Help

• Email: migrations@cyrexa.com
• Documentation: Version-specific guides
• Support: Priority support for migrations

​

Next Steps