Adyen Python API Library v14.0.0

What's Changed

This release introduces a significant refactoring of the service layer to improve modularity, corrects auto-generated method signatures, and brings several API updates and new features. It marks a major milestone in aligning the library more closely with Adyen’s OpenAPI specifications

⚠️ Find below what's new as well as a detailed summary of the Breaking Changes, and what you should do or consider.

🛠 Breaking Changes

Method Signature Correction

The code generation template was incorrectly including required request body parameters as separate, unused arguments in service methods. The template has been corrected to only include required pathParams in the method signature alongside the request object.

This fixes incorrect method signatures across multiple services. As a result, methods that previously had duplicated and unused arguments now have a cleaner signature.

Action required: review the method signatures for the services you use and remove any unused arguments from your calls. Examples of this change include:

• SessionAuthentication API: authenticationSessionRequest parameter removed from create_authentication_session.
• BalancePlatform API:
  • authorisedCardUsers parameter removed from create_authorised_card_users and update_authorised_card_users.
  • balanceWebhookSettingInfo parameter removed from create_webhook_setting.
  • balanceWebhookSettingInfoUpdate parameter removed from update_webhook_setting.

Service folder restructuring

To ensure a consistent directory structure and improve modularity, several services have been moved from the services folder into their own dedicated subdirectories (e.g., Adyen/services/balanceControl/):
balanceControl, binLookup, dataProtection, disputes, posMobile, recurring, storedValue.

Introducing service wrappers

To ensure a consistent way of accessing service functionality, the restructured services now use a wrapper class that exposes their endpoints through the shared Adyen client.
This structure, already used by services like checkout and balancePlatform, now applies to: balanceControl, binLookup, dataProtection, disputes, posMobile, recurring, and storedValue.

Action required: update your code to call the API via the new wrapper structure.
For example:

# Before
result = adyen.binlookup.get_cost_estimate(request)

# After
result = adyen.binlookup.bin_lookup_api.get_cost_estimate(request)

💎 New Features

Legal Entity Management API v4

The library now supports Legal Entity Management API v4. LEM v4 enhances the onboarding process and ensures compliance with evolving regulatory data requirements across regions and products.

See the Onboarding v4 documentation for details, and review the API changes from v3 to v4 to understand the impact on your integration.

Balance Platform API

• Added the new TransferLimitsBalanceAccountLevelApi.
• Added the new TransferLimitsBalancePlatformLevelApi.

Checkout API

• Added the validate_shopper_id method to the UtilityApi.

🐞 Bug Fixes

• Generator: Fixed the api.mustache template to prevent duplicating request body fields in method signatures. This corrects method signatures across multiple services.
• SessionAuthentication: Corrected the URL mapping for the live endpoint.

What's Changed

Breaking Changes 🛠

• Fix(generator): Correct method signatures and refactor services by @galesky-a in #393

Fixes ⛑️

• Release Workflow: run only for PRs from maintainers by @gcatanese in #387
• Add workflow_call trigger to python-ci.yml by @gcatanese in #391

Other Changes 🖇️

• Set workflow permissions by @gcatanese in #377
• FIX: explicitly callout how to initialize individual api clients by @galesky-a in #383
• FIX: typo in readme by @galesky-a in #385
• fix: Correct possdk live endpoint construction by @galesky-a in #386
• Add @Adyen/api-library-maintainers to CODEOWNERS by @gcatanese in #389
• Release v14.0.0 by @AdyenAutomationBot in #379

New Contributors

• @galesky-a made their first contribution in #383

Full Changelog: v13.6.0...v14.0.0

Adyen Python API Library v13.6.0

What's Changed

New Features 💎

Configuration API / Payment Instruments

• Added support for:

  • get_network_token_activation_data - Get the network token activation data for a payment instrument.
  • create_network_token_provisioning_data - Create provisioning data for a network token. Use the provisioning data to add a user's payment instrument to their digital wallet.

• Code generation: update services and models by @AdyenAutomationBot in #373

Other Changes 🖇️

• Release v13.6.0 by @AdyenAutomationBot in #372

Full Changelog: v13.5.1...v13.6.0

Adyen Python API Library v13.5.1

What's Changed

Patch to rename the authorized_card_users_api methods

Other Changes 🖇️

• Code generation: update services and models by @AdyenAutomationBot in #370
• Release v13.5.1 by @AdyenAutomationBot in #371

Full Changelog: v13.5.0...v13.5.1

Adyen Python API Library v13.5.0

What's Changed

New Features 💎

• BalancePlatform:
  • Added AuthorizedCardUsersApi
  • Added BalancesApi
• SessionAuthentication:
  • Added SessionAuthenticationApi

Other Changes 🖇️

• Deprecated AdyenBalanceControlApi methods
• Deprecated AdyenRecurringApi methods
• Deprecated POS Terminal Management API, ❗ use instead the Management API for the management of your terminal fleet ❗
• Code generation: update services and models by @AdyenAutomationBot in #363
• Add close-issue-label flag to correctly label closed issues by @DjoykeAbyah in #364
• Improve GitHub workflows by @ayodejidev in #367
• Deprecate POSTFM API by @gcatanese in #368
• Add GitHub issue form by @ayodejidev in #362
• Release v13.5.0 by @AdyenAutomationBot in #365

Full Changelog: v13.4.0...v13.5.0

Adyen Python API Library v13.4.0

What's Changed

New Features 💎

• BalancePlatform:

  • Inmanage_sca_devices_api added complete_association_between_sca_device_and_resource and initiate_association_between_sca_device_and_resource to complete an association between an SCA device and a resource and initiate an association between an SCA device and a resource.

• Code generation: update services and models by @AdyenAutomationBot in #359

Other Changes 🖇️

• BalancePlatform:
  • Deprecation message added in grant_accounts_api and grant_offers_api.
• Transfers:
  • Deprecation message added in capital.
• Release v13.4.0 by @AdyenAutomationBot in #361

Full Changelog: v13.3.0...v13.4.0

Adyen Python API Library v13.3.0

What's Changed

• In Terminal deprecated assign_terminals, find_terminal, get_stores_under_account, get_terminal_details and get_terminals_under_account
• Update all services by @AdyenAutomationBot in #357

Other Changes 🖇️

• Release v13.3.0 by @AdyenAutomationBot in #358

Full Changelog: v13.2.0...v13.3.0

Adyen Python API Library v13.2.0

What's Changed

New Features 💎

• LegalEntityManagement:
  • Added calculate_pci_status_of_legal_entity in pci_questionnaires_api
• Update all services by @AdyenAutomationBot in #355

Other Changes 🖇️

• Release v13.2.0 by @AdyenAutomationBot in #356

Full Changelog: v13.1.0...v13.2.0

Adyen Python API Library v13.1.0

What's Changed

New Features 💎

• BalancePlatform
  • Added get_all_transaction_rules_for_account_holder to get all transaction rules for an account holder
  • Added get_all_transaction_rules_for_balance_account to get all transaction rules for a balance account
  • Added get_all_transaction_rules_for_balance_platform to get all transaction rules for a balance platform
• Update all services by @AdyenAutomationBot in #346

Other Changes 🖇️

• Create renovate.json with minimum required release age by @ayodejidev in #347
• Create codeql-analysis.yml by @ayodejidev in #352
• chore(deps): update actions/setup-python action to v5 by @renovate in #353
• chore(deps): update actions/labeler action to v5 by @renovate in #350
• chore(deps): update actions/checkout action to v4 by @renovate in #349
• Release v13.1.0 by @AdyenAutomationBot in #348

New Contributors

• @ayodejidev made their first contribution in #347
• @renovate made their first contribution in #353

Full Changelog: v13.0.0...v13.1.0

Adyen Python API Library v13.0.0

What's Changed

Breaking Changes 🛠

• Checkout API:
  • Removal of ClassicCheckoutSDKApi
• Update all services by @AdyenAutomationBot in #341

New Features 💎

• LegalEntityManagement API:
  • In terms_of_service_api added get_accepted_terms_of_service_document
• Update all services by @AdyenAutomationBot in #326
• Update all services by @AdyenAutomationBot in #329
• Update all services by @AdyenAutomationBot in #337

Fixes ⛑️

• Update setup.py by @jillingk in #340
• adjusted deprecated repository_url with repository-url by @DjoykeAbyah in #342
• Fix excluding files properly by @jillingk in #345
• Update pypipublish.yml by @jillingk in #344

Other Changes 🖇️

• updated stalebot by @DjoykeAbyah in #324
• updated readme by @DjoykeAbyah in #328
• Release v12.6.0 by @AdyenAutomationBot in #325
• Update client.py by @jillingk in #330
• included link to API-Explorer for Readme PaymentsApp API by @DjoykeAbyah in #332
• Release v12.7.0 by @AdyenAutomationBot in #331
• Update CODEOWNERS by @acampos1916 in #335
• Update all services by @AdyenAutomationBot in #333
• Release v12.7.1 by @AdyenAutomationBot in #336
• Add deprecation info as comments by @gcatanese in #338
• Release v12.8.0 by @AdyenAutomationBot in #339
• Release v13.0.0 by @AdyenAutomationBot in #343

Full Changelog: v12.5.1...v13.0.0

Adyen Python API Library v12.8.0

What's Changed

New Features 💎

• Transfers API:
  • In TransfersApi approve_initiated_transfers added and cancel_initiated_transfers in to initiate the approval of a list of transfers that triggered an additional review and initiate a cancellation of a list of transfers that triggered an additional review
• Update all services by @AdyenAutomationBot in #337

Fixes ⛑️

• Update setup.py by @jillingk in #340
  • Resolved an issue where test files were mistakenly included in the PyPI distribution. This was corrected by updating the setup.py file to explicitly exclude test files from the final package build.

Other Changes 🖇️

• Add deprecation info as comments by @gcatanese in #338
• Release v12.8.0 by @AdyenAutomationBot in #339

Full Changelog: v12.7.1...v12.8.0