feature/INT-1655 - Support for negotiating Accounts API schema version via the Accept header - #351
Merged
Merged
Conversation
armando-rodriguez-cko
previously approved these changes
Jul 20, 2026
|
armando-rodriguez-cko
approved these changes
Jul 22, 2026
This file contains hidden or bidirectional Unicode text that may be interpreted or compiled differently than what appears below. To review, open the file in an editor that reveals hidden Unicode characters.
Learn more about bidirectional Unicode characters
Sign up for free
to join this conversation on GitHub.
Already have an account?
Sign in to comment
2 participants
Add this suggestion to a batch that can be applied as a single commit.This suggestion is invalid because no changes were made to the code.Suggestions cannot be applied while the pull request is closed.Suggestions cannot be applied while viewing a subset of changes.Only one suggestion per line can be applied in a batch.Add this suggestion to a batch that can be applied as a single commit.Applying suggestions on deleted lines is not supported.You must change the existing code in this line in order to create a valid suggestion.Outdated suggestions cannot be applied.This suggestion has been applied or marked resolved.Suggestions cannot be applied from pending reviews.Suggestions cannot be applied on multi-line comments.Suggestions cannot be applied while the pull request is queued to merge.Suggestion cannot be applied right now. Please check back later.
This pull request 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
Acceptheader, 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:
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:
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]BusinessTypeand new entity roles inEntityRolesfor v3.0 compatibility. [1] [2]New Supporting Data Classes for v3.0:
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:
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:
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.