Repository navigation
6.5.0
Release 6.5.0 (#386)
This release introduces comprehensive improvements to the PHP SDK's payment and processing data models, focusing on documentation clarity, alignment with API specifications, and enhanced support for accommodation and airline payment features. The changes include detailed docblocks for classes and properties, deprecation notices for outdated fields, and new or updated models for handling accommodation and airline data across different payment flows.
Documentation and Specification Alignment
- Added or improved docblocks for nearly all major payment-related classes (e.g.,
AccommodationData,AccommodationGuest,AccommodationRoom,Passenger,FlightLegDetails, airline data classes) to clarify their purpose and usage. [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] - Updated property annotations to use correct array/object types, added
[Optional]markers, and provided detailed notes on API quirks, expected types, and backward compatibility. [1] [2] [3] [4] [5] [6]
Accommodation and Airline Data Enhancements
- Added new properties to
AccommodationData(e.g.,property_phone,customer_service_phone) and introduced theAccommodationPhonemodel to support richer accommodation contact details. [1] [2] - Refined airline and accommodation data handling in processing and payment context classes, ensuring correct property names and types per API requirements (e.g.,
planinstead ofbilling_plan,ticket/passengeras objects not arrays, use of shared models). [1] [2] [3]
Deprecations and Backwards Compatibility
- Added deprecation notices for properties and classes no longer supported by the API (e.g.,
service_classinFlightLegDetails,PaymentContextsPartnerCustomerRiskData), with guidance on preferred alternatives. [1] [2] - Clarified which properties are retained for backwards compatibility and which are ignored by the gateway. [1] [2]
Schema and Model Corrections
- Updated several models to use the correct local versions (e.g.,
PaymentSetupAccommodationAddress,PaymentSetupAccommodationRoom) where the schema differs from the main payment models. [1] [2] - Improved handling and documentation of airline and accommodation arrays in processing settings, payment contexts, and main payment requests. [1] [2] [3]
New Models
- Introduced
AccommodationPhoneto encapsulate property and customer service phone details for accommodations.
These changes significantly improve the maintainability, correctness, and clarity of the SDK's payment data models, making integration with the Checkout API more predictable and robust.