feature/INT-1659 - Accept header + schema 3.0 initial development

[david-ruiz-cko]

This pull request introduces several enhancements and extensions to the Accounts API client, focusing on improved schema versioning support, expanded entity management, and broader business type and role coverage. The changes add flexible API methods to specify schema versions, introduce new model fields and types, and extend enums to support a wider range of business and company scenarios.

API client enhancements for schema versioning:

• Added overloaded methods to ApiClient and AccountsClient (both async and sync) to accept custom headers, specifically to support specifying a schemaVersion for requests. Default schema version is set to "3.0" if not provided. (src/main/java/com/checkout/ApiClient.java, src/main/java/com/checkout/ApiClientImpl.java, src/main/java/com/checkout/accounts/AccountsClient.java, src/main/java/com/checkout/accounts/AccountsClientImpl.java) [1] [2] [3] [4] [5] [6] [7] [8] [9] [10] [11] [12] [13] [14] [15] [16]

Model and enum extensions:

• Added new model classes and fields to support additional business requirements:

  • Introduced AgreedTerms model for capturing agreement metadata. (src/main/java/com/checkout/accounts/AgreedTerms.java)
  • Added additionalTradingNames and isRegisteredCompany fields to Company. (src/main/java/com/checkout/accounts/Company.java)
  • Added day field to DateOfIncorporation. (src/main/java/com/checkout/accounts/DateOfIncorporation.java)
  • Introduced new enum CompanyPosition for more granular company role identification. (src/main/java/com/checkout/accounts/CompanyPosition.java)

• Expanded supported business types and entity roles:

  • Extended BusinessType enum with many new types (e.g., INDIVIDUAL_OR_SOLE_PROPRIETORSHIP, NON_PROFIT_ENTITY, etc.). (src/main/java/com/checkout/accounts/BusinessType.java)
  • Extended EntityRoles enum with new roles (DIRECTOR, CONTROL_PERSON). (src/main/java/com/checkout/accounts/EntityRoles.java)

These changes provide greater flexibility for clients to interact with the API using different schema versions, and ensure the models and enums better reflect the diverse range of business entities and roles that may be encountered.

[agent-wall-e]

🟡 Risk Classification: MINOR

Approval route: AI Review + Human Approval
Rollback controls: Staged rollout + rollback

Classification reasons

• exceeds_bounded_scope:374>200

Operational gates

• ✅ jira_ticket (INT-1659)
• ✅ independent_review

Files analysed: 22

---

_{wall-e 2026.06.19-02 · policy 376219bc71e6…}

[agent-wall-e]

🔬 Debug — why this classification?

Each reason code emitted by the classifier, its source clause in the AI in SDLC Control Framework, and what it means.

Reason code	Kind	Clause	Meaning
exceeds_bounded_scope — 374>200	classifying	§2.1 M8	More than 200 non-test, non-doc, non-lockfile lines changed.

Kinds:

• classifying — this rule contributed to the chosen tier.
• informational — context only; did not by itself decide the tier.

See issue #3 for the proposal to formalise this map as Appendix A of the standards doc.

_{wall-e 2026.06.19-02 · debug}

[agent-wall-e]

🟡 Risk Classification: MINOR

Approval route: AI Review + Human Approval
Rollback controls: Staged rollout + rollback

Classification reasons

• exceeds_bounded_scope:389>200

Operational gates

• ✅ jira_ticket (INT-1659)
• ✅ independent_review

Files analysed: 22

---

_{wall-e 2026.06.19-02 · policy 376219bc71e6…}

[agent-wall-e]

🔬 Debug — why this classification?

Each reason code emitted by the classifier, its source clause in the AI in SDLC Control Framework, and what it means.

Reason code	Kind	Clause	Meaning
exceeds_bounded_scope — 389>200	classifying	§2.1 M8	More than 200 non-test, non-doc, non-lockfile lines changed.

Kinds:

• classifying — this rule contributed to the chosen tier.
• informational — context only; did not by itself decide the tier.

See issue #3 for the proposal to formalise this map as Appendix A of the standards doc.

_{wall-e 2026.06.19-02 · debug}

[sonarqubecloud]

Quality Gate passed

Issues
3 New issues
0 Accepted issues

Measures
0 Security Hotspots
0.0% Coverage on New Code
0.0% Duplication on New Code

See analysis details on SonarQube Cloud