> ## Documentation Index > Fetch the complete documentation index at: https://docs.caibo.digital/llms.txt > Use this file to discover all available pages before exploring further. # Changelog > Version history, breaking changes, and deprecation policy for Caibo H2H API # Changelog Track API updates, new features, and breaking changes for Caibo Host-to-Host integration. ## 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 ```javascript theme={null} // 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 ```javascript theme={null} // Deprecated (will be removed June 2024) headers: { 'Authorization': 'Bearer your_token' } // Current (use this) headers: { 'X-API-Key': 'your_api_key' } ``` ## Version Support | Version | Status | Support Until | | ------- | ----------- | ------------- | | 2.1.x | Current | Active | | 2.0.x | Supported | June 2024 | | 1.5.x | Deprecated | March 2024 | | 1.4.x | End of Life | - | ## 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 ```bash theme={null} # Specify API version in requests curl -X POST https://api.caibo.com/v2/payments/h2h/1 \ -H "X-API-Key: your_key" \ -H "X-API-Version: 2.1" ``` ### Backward Compatibility We maintain backward compatibility within major versions: * **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@caibo.com](mailto:migrations@caibo.com) * **Documentation**: Version-specific guides * **Support**: Priority support for migrations ## Next Steps Current API documentation Upgrade to latest version Test your integration Get migration help