v2025.12.19.1

Tapsilat Java SDK - v2025.12.19.1 Release Notes

We are excited to announce a major update and the first stable version of the Tapsilat Java SDK. This release introduces a complete architectural overhaul, moving to a modular service-oriented design and adding support for advanced features like Subscriptions and Payment Terms.

Key Changes & Improvements

Major Package Refactoring

• Moved internal structure from com.tapsilat.order to the core com.tapsilat package for better modularity.
• Cleaned up models and builders to follow consistent naming conventions.

Service-Oriented Architecture

• OrderService: Dedicated service for all order-related operations (Create, List, Details, etc.).
• SubscriptionService: Complete management for recurring billing and subscriber profiles.
• BaseService: Optimized HTTP handling and internal JSON mapping using Apache HttpClient 5 and Jackson.

New Features

• Subscriptions (Recurring Payments): You can now create and manage plans and user subscriptions directly through the SDK.
• Payment Terms (Installments): Added full support for managing due dates and installment amounts via createTerm.
• Webhook Security: Added TapsilatClient.verifyWebhook helper to securely validate incoming signatures from Tapsilat.
• Health Check: Native support for API health monitoring.

Improved Reliability

• Comprehensive validation for OrderRequest before sending data to the server.
• Enhanced Java Type Safety across all models.
• Dedicated test suite integration in the publishing workflow.

Documentation

• Completely rewritten README with focus on the new service-oriented usage.
• Added updated Maven/Gradle installation guides.
• New professional examples for common flows.