5.2.0
Release 5.2.0 (#352)
** Accounts BREAKING CHANGE **
This release introduces significant enhancements and extensions to the Accounts API client and related data models to support Accounts API v3.0. The main goals are to enable schema version negotiation via the Accept header, expand the onboarding request and company models for new v3.0 fields, and add several new supporting classes for richer onboarding flows.
The most important changes are:
Accounts API v3.0 Schema Versioning Support: BREAKING CHANGE!
- Added a
DEFAULT_SCHEMA_VERSIONconstant and updated key client methods inAccountsClientto accept a$schemaVersionparameter (defaulting to 3.0), passing this as anAcceptheader to the API. This enables negotiation of the Accounts API schema version for all major entity operations. [1] [2] [3] [4] [5]
Expanded Onboarding and Company Models:
- Extended
OnboardEntityRequestandCompanywith new fields required by Accounts API v3.0, such asprocessing_details,agreed_terms,seller_category,is_draft,date_of_incorporation,regulatory_licence_number, and more. Added detailed PHPDoc for each field. [1] [2] - Added new business types in
BusinessTypeand new entity roles inEntityRolesfor v3.0 compatibility. [1] [2]
New Supporting Data Classes for v3.0:
- Introduced new classes for richer onboarding and processing details:
AgreedTerms,ProcessingDetails,ProcessingDetailsPayments,ProcessingDetailsAch,DateOfIncorporation, andCompanyPosition. These enable capturing additional information required by the latest API version. [1] [2] [3] [4] [5] [6]
OnboardSubEntityDocuments Enhancements:
- Expanded
OnboardSubEntityDocumentswith new optional document fields (e.g.,articles_of_association,shareholder_structure,bank_verification, etc.) to support the full set of required documents for different onboarding schema variants.
Documentation and Header Handling Improvements:
- Improved PHPDoc for all updated and new fields, clarifying requirements and formats. Enhanced
Headersto support the newacceptheader for schema negotiation.
These changes collectively prepare the codebase for full support of Accounts API v3.0 onboarding and entity management, while maintaining backward compatibility.