Adyen Java API Library v36.0.0

What's Changed

Breaking Changes 🛠

• ACS webhooks
  ChallengeInfo FlowEnum values have changed:
  • Fixed correct FlowEnum-values in ChallengeInfo - "OTP_SMS" and "OOB" were not used previously and now have been updated to correct values.
  • Fix: OTP_SMS -> PWD_OTP_PHONE_FL - One-Time Password via SMS
  • Fix: OOB -> OOB_TRIGGER_FL - Out-Of-Band flow

Features 💎

• Checkout

  • add support for RakutenPay
  • add RequestedTestAcquirerResponseCode in AdditionalDataCommon

• AcsWebhooks:

  • Add Out-of-band authentication requested webhook event
  • Add new enum PWD_OTP_EMAIL_FL (One-Time Password via Email)

• Configuration webhooks

  • Add enum PENDINGin SweepConfigurationV2.

• LEM API

  • Add attribute allowDebugUi in OnboardingLinkSettingsto debug user interface (UI) when applicable.

• Transactions webhooks

  • Add enum DCCPLATFORMCOMMISSION in PlatformPayment

• Transfers API

  • Add enum DCCPLATFORMCOMMISSION in PlatformPayment
  • Add enum PENDINGin TransferData
  • Add attribute externalReason in TransferData
  • Add scaOnApproval attribute in TransferReview

Other Changes 🖇️

Note: enums instantiation has changed, this shouldn't impact the usage of the enums
Example, from PERMATA_LITE_ATM("doku_permata_lite_atm") to DOKU_PERMATA_LITE_ATM(String.valueOf("doku_permata_lite_atm"))

• Improve Github workflows by @ayodejidev in #1440
• Add close-issue-label flag to correctly label closed issues by @DjoykeAbyah in #1442
• iDEAL2 unit test update by @gcatanese in #1443
• Ovverride default ApiError message with the error message from the API response by @gcatanese in #1447
• Add OpenAPI Generator v7 mustache templates by @gcatanese in #1444
• ACS webhooks update: RelayedAuthenticationRequest event code by @gcatanese in #1449
• Checkout API code generation: RakutenPay by @gcatanese in #1450
• Release v36.0.0 by @AdyenAutomationBot in #1441

Full Changelog: v35.0.0...v36.0.0

Adyen Java API Library v35.0.0

What's Changed

Breaking Changes 🛠

• Management API:
  • In AndroidApp the field status has changed from String to StatusEnum (ARCHIVED, ERROR, INVALID, PROCESSING, READY)
• Management webhooks:
  • In PaymentMethodRequestRemovedNotificationRequest the event type has been renamed to paymentMethodRequest.removed
  • In PaymentMethodScheduledForRemovalNotificationRequest the event type has been renamed to paymentMethodRequest.scheduledForRemoval

New Features 💎

Add support for Session Authentication API to create the sessions required for integrating Adyen Platform components (#1435)

• Checkout:
  • New payment methods PixDetails and PixRecurring
  • In PaymentRefundResponse add attribute capturePspReference (only available for PayPal refunds)
  • In ResponseAdditionalDataCommon:
    • ⚠️ the recurringRecurringDetailReference and recurringShopperReference are deprecated, use instead the new attribute tokenizationShopperReference
    • add tokenizationStoreOperationType and tokenizationStoredPaymentMethodId attributes, add TokenizationStoreOperationTypeEnum enum
• Management API:
  • Support AffirmInfo and PayToInfo payment methods
  • in Surcharge class add attribuge excludeGratuityFromSurcharge
• Payout:
  • In ResponseAdditionalDataCommon:
    • ⚠️ the recurringRecurringDetailReference and recurringShopperReference are deprecated, use instead the new attribute tokenizationShopperReference
    • add tokenizationStoreOperationType and tokenizationStoredPaymentMethodId attributes, add TokenizationStoreOperationTypeEnum enum
• Classic Payments:
  • In ResponseAdditionalDataCommon:
    • ⚠️ the recurringRecurringDetailReference and recurringShopperReference are deprecated, use instead the new attribute tokenizationShopperReference
    • add tokenizationStoreOperationType and tokenizationStoredPaymentMethodId attributes, add TokenizationStoreOperationTypeEnum enum
• Terminal API:
  • Add SaleReferenceID field in CustomerOrder class (#1436)

Important

The Recurring API is deprecated. Use the Checkout API recurring endpoints instead.

Other Changes 🖇️

• feat(tls): allow disabling protocol upgrade by @sp00m in #1425
• Improve issue template by @ayodejidev in #1434
• chore(deps): update dependency org.apache.maven.plugins:maven-checkstyle-plugin to v3.6.0 by @renovate in #1381
• fix(exception): better handle non-JSON response bodies by @sp00m in #1404
• Code generation: update services and models by @AdyenAutomationBot #1433
• Release v35.0.0 by @AdyenAutomationBot in #1437
• Session Authentication API #1435 by @gcatanese

Full Changelog: v34.0.0...v35.0.0

Adyen Java API Library v34.0.0

What's Changed

Breaking Changes 🛠

• BalancePlatform:
  • Removed PriorityRestriction class.
  • In TransactionRuleRestriction removed priority.
• BinLookup:
  • In CostEstimateResponse removed surchargeType.
• Transfers:
  • In TransferReview removed numberOfApprovalsCompleted and scaOnApproval.
• TransferWebhook:
  • In TransferReview removed numberOfApprovalsCompleted and scaOnApproval.

Features 💎

• AcsWebhooks:

  • In ChallengeInfo broadening the range of ChallengeCancelEnum.

• BalancePlatform:

  • Added AssociationDelegatedAuthenticationData, AssociationFinaliseRequest, AssociationFinaliseResponse, AssociationInitiateRequest, AssociationInitiateResponse and TokenRequestorsRestriction class.
  • In TransactionRuleRestriction added tokenRequestors.

• Checkout:

  • In CardDetails, CardDonations and CheckoutPaymentMethod added fastlaneData.
  • Added FastlaneDetails class.

• LegalEntityManagement:

  • Added FinancialReport class.
  • In LegalEntityAssociation added nominee.
  • In Organization and SoleProprietorship added financialReports.

• Service:

  • BalancePlatform:
    • Deprecated GrantAccountsApi and GrantOffersApi.
    • In ManageSCADevicesApi added completeAssociationBetweenScaDeviceAndResource and initiateAssociationBetweenScaDeviceAndResource.
  • Transfers:
    • Deprecated CapitalApi.

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

Other Changes 🖇️

• chore(deps): update dependency org.mockito:mockito-core to v5.15.2 by @renovate in #1348
• Fix failing failing step for external forks by @ayodejidev in #1429
• Update Java version in POM file by @gcatanese in #1432
• Release v34.0.0 by @AdyenAutomationBot in #1427

Full Changelog: v33.1.0...v34.0.0

Adyen Java API Library v33.1.0

What's Changed

New Features 💎

Add Negative Balance Warning

• Webhooks:
  • Classic Payments
  • Add TopUp enum in Split class

Other Changes 🖇️

• Improve exception logging in BankingWebhookHandler
• OpenAPI spec files or templates have been modified on 29-01-2025 by commit. Download OpenAPI diffs to view the changes.
• Code generation: update services and models by @AdyenAutomationBot in #1423
• Add deprecation of POS Terminal Management API by @gcatanese in #1420
• Improve deserialization unit testing by @gcatanese in #1421
• Code generation: update services and models by @AdyenAutomationBot in #1424
• Release v33.1.0 by @AdyenAutomationBot in #1422

Full Changelog: v33.0.0...v33.1.0

Adyen Java API Library v33.0.0

What's Changed

Breaking Changes 🛠

• Checkout API:
  *airlinePassengerTelephoneNumber attribute renamed to airlinePassengerPhoneNumber in AdditionalDataAirline

New Features 💎

• Checkout API:
  • Add AffirmDetails payment method
  • Add PayPayDetails payment method
  • Add TopUp enum in Split class
  • Add autoRescue attribute in AdditionalDataCommon - Set to true to enable Auto Rescue
  • Add maxDaysToRescue in AdditionalDataCommon - Specify the rescue window for a transaction, in days, when autoRescue is set to true. You can specify a value between 1 and 48.
• Report webhooks:
  • Add id attribute in ReportNotificationData class

Other changes 🖇️

Important

From January 1, 2025 POS Terminal Management API is deprecated and support stops on April 1, 2025. To automate the management of your terminal fleet, use our Management API.

Before: (deprecated) https://postfmapi-test.adyen.com/postfmapi/terminal/v1/getTerminalDetails We've moved the fields TerminalStatus to lastActivityAt and data.AssignmentStatus.
Note that your API-credentials requires the following permission: Management API — Terminal actions read.

// TerminalStatus:

ONLINELAST1DAY ("OnlineLast1Day")
ONLINELAST2DAYS ("OnlineLast2Days")
ONLINELAST3DAYS ("OnlineLast3Days")
ONLINELAST4DAYS ("OnlineLast4Days")
ONLINELAST5DAYS ("OnlineLast5Days")
ONLINELAST6DAYS ("OnlineLast6Days")
ONLINELAST7DAYS ("OnlineLast7Days")
ONLINETODAY ("OnlineToday")
REASSIGNTOINVENTORYPENDING ("ReAssignToInventoryPending")
REASSIGNTOMERCHANTINVENTORYPENDING ("ReAssignToMerchantInventoryPending")
REASSIGNTOSTOREPENDING ("ReAssignToStorePending")
SWITCHEDOFF ("SwitchedOff")

• Code generation: update services and models by @AdyenAutomationBot in #1417
• Release v33.0.0 by @AdyenAutomationBot in #1419

Full Changelog: v32.2.0...v33.0.0

Adyen Java API Library v32.2.0

What's Changed

New Features 💎

• BalancePlatform:
  • Added PriorityRestriction class.
  • In TransactionRuleRestrictions added priority.
  • In VerificationDeadline, VerificationError and VerificationErrorRecursive added issueChargeCard, issueChargeCardCommercial , useChargeCard and useChargeCardCommercial enum.
• ConfigurationWebhooks:
  • In VerificationDeadline, VerificationError and VerificationErrorRecursive added issueChargeCard, issueChargeCardCommercial , useChargeCard and useChargeCardCommercial enum.
• LegalEntityManagement:
  • In VerificationDeadline, VerificationError and VerificationErrorRecursive added issueChargeCard, issueChargeCardCommercial , useChargeCard and useChargeCardCommercial enum.
• Update all services by @AdyenAutomationBot in #1416

Other Changes 🖇️

• feat(tls): allow disabling protocol upgrade by @sp00m in #1409
• Revert "feat(tls): allow disabling protocol upgrade" by @DjoykeAbyah in #1414
• Adjust Region class with valid regions plus endpoint mappings for terminal api live by @DjoykeAbyah in #1407
• Release v32.2.0 by @AdyenAutomationBot in #1415

Full Changelog: v32.1.0...v32.2.0

Adyen Java API Library v32.1.0

What's Changed

New Features 💎

• BalancePlatform:
  • Added CounterpartyTypesRestriction and SourceAccountTypesRestriction class
  • In TransactionRuleRestrictions added counterpartyTypes and sourceAccountTypes
• ConfigurationWebhooks:
  • In AccountHolderNotificationRequest, BalanceAccountNotificationRequest, CardOrderNotificationRequest, PaymentNotificationRequest and SweepConfigurationNotificationRequest added timestamp
• Management:
  • In TerminalConnectivityCellular added iccid2
  • In UpdatePaymentMethodInfo added storeId
• ManagementWebhooks:
  • Added TerminalAssignmentNotificationRequest and TerminalAssignmentNotificationResponse class
• ReportWebhooks:
  • In ReportNotificationRequest added timestamp

• Update all services by @AdyenAutomationBot in #1405

Other Changes 🖇️

• Use a dynamically-generated, random IV by @ayodejidev in #1410
• Deprecate TerminalLocalAPIUnencrypted.java by @ayodejidev in #1412
• Release v32.1.0 by @AdyenAutomationBot in #1411

Full Changelog: v32.0.0...v32.1.0

Adyen Java API Library v32.0.0

What's Changed

Breaking Changes 🛠

• LegalEntityManagament:
  • In Trust removed setTaxAbsent attribute
• Management:
  • In JCBInfo removed serviceLevel null check
• Classic Payments:
  • Enums in ModificationResult updated to contain underscore prefix eg. CAPTURE_RECEIVED_ to _CAPTURE_RECEIVED_

New Features 💎

• AcsWebhooks:
  • In AuthenticationNotificationData added timestamp attribute
• Checkout:
  • In CardDetails and CardDonations added encryptedCard attribute and clicktopay enum
  • In CheckoutPaymentMethod added encryptedCard, bank, clientType, identification and identificationType attributes
  • In DonationPaymentMethod added encryptedCard attribute
  • Added PseDetails class
• DisputeWebhooks:
  • Added Amount class
  • Added BalancePlatformNotificationResponse class
  • Added DisputeEventNotification
  • Added DisputeNotificationRequest class
  • Added Modelnterface class
  • Added ObjectSerializer class
• LegalEntityManagament:
  • In PCIQuestionnairesApi added calculatePciStatusOfLegalEntity
  • Added CalculatePciStatusRequest class
  • Added CalculatePciStatusResponse class
  • In LegalEntity added unincorporatedPartnership attribute
  • In LegalEntityAssociation added secondaryPartner and unincorporatedPartnership attributes
  • In LegalEntityInfo and LegalEntityInfoRequiredType added unincorporatedPartnership attribute
  • In OnboardingLinkSettings added enforceLegalAge attribute
  • In PhoneNumber added phoneCountryCode attribute
  • In Trust added description , businessTrust, charitableTrust, discretionaryTrust and familyTrust attributes
  • Added UnincorporatedPartnership class
• Management:
  • Added DinersInfo class
  • In PaymentMethod and PaymentMethodSetupInfo replaced import from GenericPmWithTdinfo to DinersInfo
  • In PaymentMetdhoResponse added affirm attribute
• TransactionWebhooks:
  • In TransactionNotificationRequestV4 added timestamp attribute
  • In PlatformPayment added topUp enum value indicating the nature of the transfer
• TransferWebhooks:
  • Added Airline class
  • Added Leg class
  • Added MerchantPurchaseData class
  • In TransferData added eventId attribute and topUp enum value for category of the transfer
  • In TransferEvent added eventsData
  • Added TransferEventEventsDataInner class
  • In TransferNotificationRequest added timestamp
• Transfers:
  • Added Airline class
  • Added Leg class
  • Added MerchantPurchaseData class
  • In Transfer and TransferInfo added topUp
  • In TransferData added eventId attribute and topUp enum value for category of the transfer
  • In TransferEvent added eventData attribute
  • Added TransferEventEventsDataInner class
• Update all services by @AdyenAutomationBot in #1395

Other Changes 🖇️

• Add Sonarcloud CI and coverage by @ayodejidev in #1400
• Release v32.0.0 by @AdyenAutomationBot in #1401

Full Changelog: v31.3.0...v32.0.0

Adyen Java API Library v31.3.0

What's Changed

New Features 💎

• BalancePlatform
  • In CreateSweepConfigurationV2, SweepConfigurationV2 and UpdateSweepConfigurationV2 added reasonDetail, a human readable reason for disabling the sweep.
• ConfigurationWebhooks
  • In SweepConfigurationV2 added reasonDetail, a human readable reason for disabling the sweep.
• Update all services by @AdyenAutomationBot in #1393

Other Changes 🖇️

• Release v31.3.0 by @AdyenAutomationBot in #1394

Full Changelog: v31.2.0...v31.3.0

Adyen Java API Library v31.2.0

New Features 💎

• Checkout API:
  • Add Riverty payment method
  • In PaymentRequest add new attribute bankAccount to define the bank account details for the payment methods when applicable (e.g. RatePay)
  • In PaymentRequest add attribute shopperConversionId

See Update all services by @AdyenAutomationBot in #1392

Other Changes 🖇️

• chore(deps): update dependency org.apache.maven.plugins:maven-javadoc-plugin to v3.11.1 by @renovate in #1347
• Add minimum required release age (Renovate[bot]) by @ayodejidev in #1391
• Release v31.2.0 by @AdyenAutomationBot in #1390

New Contributors

• @ayodejidev made their first contribution in #1391

Full Changelog: v31.1.0...v31.2.0