Balance Platform: generate models and services

[gcatanese]

Balance Platform: generate models and services

BalancePlatform API

• Add AuthorizedCardUsersService to manage (add, get, delete and update) authorized users to a given card
• Add TransferLimitsBalanceAccountLevelApi to support Transfer limits - balance account level`
• Add TransferLimitsBalancePlatformLevelApi to manage Transfer limits - balance platform level
• In AccountHoldersService. GetTaxForm add optional parameter legalEntityId
• In TransferRouteRequirements extends the support to add AdditionalBankIdentificationRequirement, USInstantPayoutAddressRequirement, USInternationalAchPriorityRequirement`
• Add enums AuBsbCode and CaRoutingNumber in AdditionalBankIdentification
• Add enum Bic to BankIdentification
• In BulkAddress add attributes Name, Line1, Line2, Line3
• Add attribute usageto Card and CardInfo to specify how many times the card can be used: singleUse or multiUse.
• Add enums ApprovalExpired, Pending, SchemeAdvice to CreateSweepConfigurationV2, UpdateSweepConfigurationV2 and SweepConfigurationV2

• Add attributes ReplacedById and ReplacementOfId in PaymentInstrument, UpdatePaymentInstrument
• Add attributes WalletProviderAccountScore, WalletProviderDeviceScore, WalletProviderDeviceType in TransactionRuleRestrictions
• Add enum Interest in TransferRoute
• Add enum DataReview

⚠️ Removing of unused attributes
Several attributes (cardCaptureTechnology, deviceName, imei, isoDeviceType, msisdn, osVersion, paymentTypes, serialNumber, storageTechnology) have been removed DeviceInfo: this is NOT considered a breaking change since those attributes were never included in the API response

BalancePlatform Webhooks

• In BulkAddress add attributes Name, Line1, Line2, Line3
• Add attribute usageto Card
• Add attribute DeviceId in Device
• Add attributes SchemeRiskScore and TransactionRulesResult in NetworkTokenNotificationDataV2
• Add enums ApprovalExpired, SchemeAdvice toSweepConfigurationV2`


[gemini-code-assist]

Summary of Changes

Hello @gcatanese, I'm Gemini Code Assist¹! I'm currently reviewing this pull request and will post my feedback shortly. In the meantime, here's a summary to help you and other reviewers quickly get up to speed!

This pull request integrates significant updates to the Adyen Balance Platform API client, primarily focusing on expanding its capabilities for managing financial instruments and associated controls. The changes introduce new services and models for handling authorized card users, network token provisioning, and transfer limits, alongside general enhancements to existing data structures and their documentation. The update ensures the client remains aligned with the latest Balance Platform API specifications.

Highlights

• New API Endpoints and Services: Introduced new services and models for managing authorized card users, network token provisioning data, and transfer limits at both balance account and platform levels. This includes functionalities like creating, retrieving, updating, and deleting authorized card users, as well as creating, approving, deleting, and fetching transfer limits.
• Expanded Model Capabilities: Enhanced existing models with new properties and enum values to support additional functionalities. Notable updates include new bank identification types (Australian BSB, Canadian Routing Number, BIC), card usage types (singleUse, multiUse), and properties for payment instrument replacement.
• New Supporting Models: Added numerous new models to support the expanded API, such as ApproveTransferLimitRequest, CreateScaInformation, CreateTransferLimitRequest, DefaultErrorResponseEntity, LimitStatus, NetworkTokenActivationDataRequest, NetworkTokenActivationDataResponse, NetworkTokenRequestor, ScaEntity, ScaEntityType, ScaExemption, ScaInformation, ScaStatus, Scope, TransferLimit, TransferLimitListResponse, TransferType, USInstantPayoutAddressRequirement, USInternationalAchPriorityRequirement, WalletProviderAccountScoreRestriction, WalletProviderDeviceScore, and WalletProviderDeviceType.
• Improved Documentation and Validation: Updated documentation across various models to provide clearer descriptions, updated API explorer links, and more accurate examples. Currency validation for Amount models was also adjusted.
• Test Coverage: Added comprehensive test cases and corresponding mock JSON responses for all newly introduced API functionalities and models in Adyen.Test.

🧠 New Feature in Public Preview: You can now enable Memory to help Gemini Code Assist learn from your team's feedback. This makes future code reviews more consistent and personalized to your project's style. Click here to enable Memory in your admin console.

Using Gemini Code Assist

The full guide for Gemini Code Assist can be found on our documentation page, here are some quick tips.

Invoking Gemini

You can request assistance from Gemini at any point by creating a comment using either /gemini <command> or @gemini-code-assist <command>. Below is a summary of the supported commands on the current page.

Feature	Command	Description
Code Review	/gemini review	Performs a code review for the current pull request in its current state.
Pull Request Summary	/gemini summary	Provides a summary of the current pull request in its current state.
Comment	@gemini-code-assist	Responds in comments when explicitly tagged, both in pull request comments and review comments.
Help	/gemini help	Displays a list of available commands.

Customization

To customize Gemini Code Assist for GitHub experience, repository maintainers can create a configuration file and/or provide a custom code review style guide (such as PEP-8 for Python) by creating and adding files to a .gemini/ folder in the base of the repository. Detailed instructions can be found here.

Limitations & Feedback

Gemini Code Assist may make mistakes. Please leave feedback on any instances where its feedback is incorrect or counter productive. You can react with 👍 and 👎 on @gemini-code-assist comments. If you're interested in giving your feedback about your experience with Gemini Code Assist for Github and other Google products, sign up here.

You can also get AI-powered code generation, chat, as well as code reviews directly in the IDE at no cost with the Gemini Code Assist IDE Extension.

Footnotes

1. Review the Privacy Notices, Generative AI Prohibited Use Policy, Terms of Service, and learn how to configure Gemini Code Assist in GitHub here. Gemini can make mistakes, so double check it and use code with caution. ↩

[gemini-code-assist]

Code Review

The pull request introduces new API functionalities and corresponding test cases for Balance Platform services, including network token provisioning, authorized card users management, and transfer limits at both balance account and platform levels. It also updates several model definitions, adding new fields, clarifying existing documentation, and modifying enum structures. Specifically, new enum members were added to AdditionalBankIdentification.TypeEnum, BankIdentification.IdentificationTypeEnum, and CreateSweepConfigurationV2.ReasonEnum, which resulted in renumbering existing enum values. The review comments highlight these enum renumbering changes as high-risk breaking changes, advising against modifying existing integer values for backward compatibility and instead suggesting appending new members to the end of the enum list.