What's Changed

Other Changes 🖇️

• [storedvalue] Code generation: update services and models by @AdyenAutomationBot in #917
• FIx Function curl_close() is deprecated since 8.5 (#918) by @andrej-gajduk-adyen in #921
• chore: convert deprecations to error by @jeandersonbc in #922
• Update dependency phpunit/phpunit to v9.6.34 by @renovate[bot] in #888
• Update dependency squizlabs/php_codesniffer to v4 by @renovate[bot] in #826
• chore(deps): update mcr.microsoft.com/devcontainers/php docker tag to v2 by @renovate[bot] in #824
• Update dependency phpunit/phpunit to v9.6.35 by @renovate[bot] in #925
• [payment] Code generation: update services and models by @AdyenAutomationBot in #924
• Revert "[payment] Automated update from Adyen/adyen-openapi@2f7d0e1" by @poojah-adyen in #927
• Release v30.0.2 by @AdyenAutomationBot in #928

New Contributors

• @poojah-adyen made their first contribution in #927

Full Changelog: v30.0.1...v30.0.2

Adyen PHP API Library v30.0.2 Latest

Latest

Compare

Choose a tag to compare

What's Changed

Fixes ⛑️

• Revert "[transfers] Automated update from Adyen/adyen-openapi@02d10c0" This fixes error with unintentional renaming of CapitalApi class - see #887.

Full Changelog: v30.0.0...v30.0.1

Adyen PHP API Library v30.0.1

Compare

Choose a tag to compare

Full Changelog: v29.0.0...v29.0.1

v29.0.1

Compare

Choose a tag to compare

This v29.0.0 release introduces several improvements, support of new Webhook events and several fixes.

NOTICE: Upcoming release of PHP library v30 and end of support for PHP 7.3

The next version (v30) will introduce several key improvements like native enums, named arguments and the constructor property promotion.

With the release of v30, we will also remove support for the PHP 7.3 runtime environment.

The PHP community declared PHP 7.3 End-of-Life (EOL) in 2021, meaning it no longer receives security patches or bug fixes. Consequently, our v30 library will require a newer runtime (PHP 8.1 or higher) to ensure your integration remains secure and aligned with industry standards.

We recommend upgrading your environment to maintain proper integration hygiene and access to new features.

We will provide the necessary technical details and breaking changes in the v30 release notes to assist your development team with the transition.

You can identify the integrations making use of the PHP library in the Customer Area:

Path: Developers -> Dashboard
View: “Integration types” dashboard -> 'Libraries' tab.
The “Used by” column identifies the specific merchant accounts using this library.

v29.0.0

Breaking Changes 🛠

Checkout API

A new ShopperName class has been introduced to define the name of the shopper. This change affects the shopperName property in the following classes: CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, DonationPaymentRequest, PaymentRequest.

The property type has been updated from Name to ShopperName.

Migration Steps for PHP

If you were manually creating the Name object for your requests, you must now instantiate the ShopperName model instead:

Before:

$name = new \Adyen\Model\Checkout\Name();
$name->setFirstName("John");
$request->setShopperName($name);

After:

$shopperName = new \Adyen\Model\Checkout\ShopperName();
$shopperName->setFirstName("John");
$request->setShopperName($shopperName);

Enum FRAUD_RESULT_TYPE_FRAUD has been removed from ResponseAdditionalDataCommon

New Features 💎

Checkout API

• Added support for Checkout Forward stored payment details
• Added support for UpiQrDetails payment method
• Added the SdkData property to all payment methods (i.e. AchDetails, etc..)
• Added attributes billingSequenceNumber and encryptedPassword in CardDetails, CardDonations, CheckoutPaymentMethod
• Added attributes bankCode and branchCode in CheckoutBankTransferAction, CheckoutBankTransferAction, PaymentResponseAction
• Added attribute levelTwoThree to EnhancedSchemeData
• Added enum prepaid In ApplePayDonations, CardDetails, CardDonations, PaymentMethod, VisaCheckoutDetails
• Added attributes paymentValidations and shopperTaxInfo in PaymentRequest
• Added attribute paymentValidations in PaymentResponse
• Added new contract types (EXTERNAL and ONECLICK,RECURRING) to the ContractEnum in Recurring
• Added attribute sepadirectdebitSepadirectdebitDueDate in ResponseAdditionalDataSepa
• Added ResponseAdditionalDataSwish class
• Added attribute dueDate to SepaDirectDebitDetails
• Added attribute mandate to StoredPaymentMethodResource
• Added attribute billingSequenceNumber to UpiIntentDetails
• Added attributes recurringDetailReference, storedPaymentMethodId in WeChatPayMiniProgramDetails

LegalEntity Management API

• Add support for Request Periodic Data Review
• Make optional attribute dateOfFinancialData in FinancialReport

BinLookup API

• In class Recurring add enums CONTRACT_ONECLICKRECURRING and CONTRACT_EXTERNAL

Recurring API

• In class Recurring add enums CONTRACT_ONECLICKRECURRING and CONTRACT_EXTERNAL

Payout API

• In class Recurring add enums CONTRACT_ONECLICKRECURRING and CONTRACT_EXTERNAL
• In ResponseAdditionalDataSepa add sepadirectdebitSepadirectdebitDueDate attribute
• Add class ResponseAdditionalDataSwish

Balance Platform

• Add attributes name, line1, line2, line3 in BulkAddress
• Make optional attribute number in Card
• Add attribute phone in DeviceInfo
• Add enum value dataReview in VerificationError and VerificationErrorRecursive

⚠️ 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

Transfers API

• Add attribute storedPaymentMethodId in BankAccountV3
• Add enum value STATUS_ACCEPTED in ConfirmationTrackingData
• Add attribute fundingInstrument in UltimatePartyIdentification
• Add enum value PLATFORM_PAYMENT_TYPE_DCC_MARKUP in PlatformPayment
• Add several enum values in TransferData, TransferDataCategoryData, TransferEvent

Transfer Webhooks

• Add attribute storedPaymentMethodId in BankAccountV3
• Add enum value STATUS_ACCEPTED in ConfirmationTrackingData
• Add enum value PLATFORM_PAYMENT_TYPE_DCC_MARKUP in PlatformPayment
• Add several enum values in TransferData, TransferDataCategoryData, TransferEvent

Transaction Webhooks

• Add enum DCCMarkup in PlatformPayment

Balance Webhooks

• Add support for Blocked funds released

Disputes Webhooks

• Add enum TYPE_OTHER in BalancePlatformNotificationResponse

Configuration Webhooks

• In BulkAddress add attributes line1, line2, line3, mobile, name
• Make optional attribute number in Card
• Add attribute deviceId in Device
• Add attribute schemeRiskScore in NetworkTokenNotificationDataV2.php
• Add enum value TYPE_DATA_REVIEW in VerificationError
• Add enum value TYPE_DATA_REVIEW in VerificationErrorRecursive

Management Webhooks

• Add attribute assignedToStoreId in TerminalAssignmentNotificationRequest
• Add enum TYPE_DATA_REVIEW in VerificationError

Transfer Webhooks

• Add attribute storedPaymentMethodId in BankAccountV3
• Add enum value STATUS_ACCEPTED in ConfirmationTrackingData
• Add enum value PLATFORM_PAYMENT_TYPE_DCC_MARKUP in PlatformPayment
• Add several enum values in TransferData, TransferDataCategoryData, TransferEvent

Relayed Authorization webhooks

• Add support for Relayed Authorization webhooks

Other Changes 🖇️

• Update PHPUnit to 9.6.33 to fix unsafe deserialization vulnerability by #880
• Format UserAgent on API requests by @gcatanese in #843
• AGENTS.md for contributors by @galesky-a in #842
• Tests with nested object (strictly types vs array) by @gcatanese in #845
• feat(ci): move formatting step before PR creation by @galesky-a in #846
• ci: Allow formatting to fail as before by @galesky-a in #847

Changes by PR

• [legalentitymanagement] Code generation: update services and models by @AdyenAutomationBot in #857
• Untrusted Actions Versioning by @gcatanese in #836
• [negativebalancewarningwebhooks] Code generation: update services and models by @AdyenAutomationBot in #848
• [storedvalue] Code generation: update services and models by @AdyenAutomationBot in #855
• [acswebhooks] Code generation: update services and models by @AdyenAutomationBot in #858
• [dataprotection] Code generation: update services and models by @AdyenAutomationBot in #859
• [binlookup] Code generation: update services and models by @AdyenAutomationBot in #849
• [recurring] Code generation: update services and models by @AdyenAutomationBot in #854
• [payout] Code generation: update services and models by @AdyenAutomationBot in #864
• [disputewebhooks] Code generation: update services and models by @AdyenAutomationBot in #851
• [balancecontrol] Code generation: update services and models by @AdyenAutomationBot in #852
• Add merge_group trigger to CI workflow by @Copilot in #872
• [transferwebhooks] Code generation: update services and models by @AdyenAutomationBot in #863
• [transactionwebhooks] Code generation: update services and models by @AdyenAutomationBot in #866
• [payment] Code generation: update services and models by @AdyenAutomationBot in #853
• chore(deps): update actions-ecosystem/action-add-labels digest to 1a9c371 by @renovate[bot] in #838
• [managementwebhooks] Code generation: update services and models by @AdyenAutomationBot in #856
• [transfers] Code generation: update services and models by @AdyenAutomationBot in #862
• [configurationwebhooks] Code generation: update services and models by @AdyenAutomationBot in #861
• [balancewebhooks] Code generation: update services and models by @AdyenAutomationBot in #867
• [management] Code generation: update services and models by @AdyenAutomationBot in #850
• [relayedauthorizationwebhooks] Code generation: update services and models by @AdyenAutomationBot in #870
• [checkout] Code generation: update services and models by @AdyenAutomationBot in #860
• chore(deps): update dependency phpunit/phpunit to v9.6.31 by @renovate[bot] in #822
• [balanceplatform] Code generation: update services and models by @AdyenAutomationBot in #865
• Update PHPUnit to 9.6.33 to fix unsafe deserialization vulnerability by @Copilot in #880
• Release v29.0.0 by @AdyenAutomationBot in #837

New Contributors

• @galesky-a made their first contribution in #842
• @Copilot made their first contribution in #872
• @jeandersonbc made their first contribution in #875

Full Changelog: v28.3.0...v29.0.0

Adyen PHP API Library v29.0.0

Compare

Choose a tag to compare

What's Changed

Fixes ⛑️

• Guards the two curl_close($ch) calls in CurlClient.php with is_resource($ch) so they only run on PHP < 8.0, avoiding the PHP 8.5 deprecation notice while preserving cleanup on older PHP versions (fixes #918)

Full Changelog: v28.3.0...v28.3.1

Adyen PHP API Library v28.3.1

Compare

Choose a tag to compare

Legal Entity Management API v4

LEM v4 enhances the onboarding process and ensures compliance with evolving regulatory data requirements across regions and products. #829

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

⚠️ Critical changes:

• BusinessLine: capability attribute has been removed
• SourceOfFunds: acquiringBusinessLineId attribute has been removed
• SourceOfFunds: adyenProcessedFunds attribute is now required

Other Changes 💎

• Individual: add support
• Organization: add support , doingBusinessAsAbsent, registrationNumberAbsent
• SoleProprietorship: add doingBusinessAsAbsent, registrationNumberAbsent
• Trust: add doingBusinessAsAbsent
• UnincorporatedPartnership: add doingBusinessAsAbsent
• ServiceEnum: add new value"issuing"
• SourceOfFunds: add several new attributes (amount, assetMonthsHeld, etc..)
• SourceOfFunds: add array of Financier
• SourceOfFunds. TypeEnum: add several new values ("employment", "donations", etc..)
• TaxInformation: add numberAbsent
• Document: add proofOfDirector

Balance Platform API

• Add TransferLimitsBalanceAccountLevelApi to manage Transfer limits - balance account level

• Add TransferLimitsBalancePlatformLevelApi to manage Transfer limits - balance platform level

• LEM v4 by @gcatanese in #829

Other Changes 🖇️

• [PaymentsAPIs] Code generation: update services and models by @AdyenAutomationBot in #813
• [Webhooks] Code generation: update services and models by @AdyenAutomationBot in #812
• Add @Adyen/api-library-maintainers to CODEOWNERS by @gcatanese in #827
• [PlatformsAPIs] Code generation: update services and models by @AdyenAutomationBot in #811
• Handling Unknown Enum Values test by @gcatanese in #830
• docs(README): fix typo "you account" → "your account" by @alisolphp in #832
• Release v28.3.0 by @AdyenAutomationBot in #814

New Contributors

• @alisolphp made their first contribution in #832

Full Changelog: v28.2.0...v28.3.0

Adyen PHP API Library v28.3.0

Compare

Choose a tag to compare

Features 💎

The release brings several improvements around model robustness and backward compatibility with evolving API schemas:

• Improved enum deserialisation: when an unknown enum value is found in API responses and webhooks, an exception is no longer thrown (to avoid affecting the applications). An error is logged instead while the value is still parsed. #807

Tokenization Webhooks

Add support for Tokenization Webhooks #778:

• recurring.token.alreadyExisting
• recurring.token.created
• recurring.token.disabled
• recurring.token.updated

Checkout API

• Added action attribute (PaymentDetailsResponseAction) in PaymentDetailsResponse
• Added support for PayToPaymentMethod and UPIPaymentMethod
• Added support for validateShopperId utility to validate the shopper id
• Added enum RIVERTY_INSTALLMENTS in RivertyDetails
• Added subtype attribute in RivertyDetails
• Added EnhancedSchemeData (supporting Airline enhanced scheme data) in PaymentRequest
• Added promoted attribute in PaymentMethod

BalancePlatform API

• Add new service AuthorizedCardUsersApi to manage (add, get, delete and update) authorized users to a given card
• In PaymentInstrumentsApi add methods createNetworkTokenActivationData and getNetworkTokenActivationData to create and retrieve network token activation data for a payment instrument.
• In AdditionalBankIdentification add new enums auBsbCode and caRoutingNumber
• Added support for AdditionalbankIdentificationRequirement: auBsbCode, caRoutingNumber, gbSortCode or usRoutingNumber.

• In Card add new attribute threeDSecure
• Added usage field to Card and CardInfo to specify how many times the card can be used: singleUse or multiUse.
• Added approvalExpired ReasonEnum to CreateSweepConfigurationV2, UpdateSweepConfigurationV2 and SweepConfigurationV2

• Add NetworkTokenRequestor to NetworkToken
• New walletProviderAccountScore and walletProviderDeviceScore attributes in TransactionRuleRestrictions
• Added support USInternationalAchPriorityRequirement
• Add walletProviderDeviceType in TransactionRuleRestrictions
• Add enum INTEREST in TransferRoute.CategoryEnum

LEM API

• In AdditionalBankIdentification add new enums auBsbCode and caRoutingNumber

Transfers API

• In AdditionalBankIdentification add new enums auBsbCode and caRoutingNumber
• Add attribute executionDate in Transfer, TransferData and TransferInfo
• In IssuedCard add new attribute threeDSecure
• Added email and url to PartyIdentification and UltimatePartyIdentification
• In Transfer add new attribute createdAt, deprecate creationDate (use instead createdAt)
• In TransferData add new attribute createdAt and updatedAt, deprecate creationDate (use instead createdAt)

Management API

• Add support for SepaDirectDebitInfo
• Add support for AlipayPlus and MaestroUsa payment methods: see PaymentMethod and PaymentMethodSetupInfo classes
• In PaymentMethodResponse, PaymentMethodSetupInfo and UpdatePaymentMethodInfo several TypesWithErrorsEnum enums have been added (alipay_plus, avancard, cooper, etc..
• In Store, StoreCreationRequest, UpdateStoreRequest and StoreCreationWithMerchantCodeRequest add attribute subMerchantData

ACS Webhooks

• Update deserialization to handle unknown enums
• Add support for balancePlatform.authentication.relayed event
• In RelayedAuthenticationRequest add new attributes threeDSRequestorAppURL, environment, timestamp, type

Report Webhooks

• Update deserialization to handle unknown enums

Transaction Webhooks

• Update deserialization to handle unknown enums
• In IssuedCard add new attribute threeDSecure
• In TransferViewCategoryData add new attribute threeDSecure

Tranfers Webhooks

• Update deserialization to handle unknown enums
• In IssuedCard add new attribute threeDSecure
• In TransferViewCategoryData add new attribute threeDSecure
• In AdditionalBankIdentification add new enums auBsbCode and caRoutingNumber
• Add attribute executionDate in Transfer, TransferData and TransferInfo
• Added email and url to PartyIdentification and UltimatePartyIdentification
• In TransferData add new attribute createdAt and updatedAt, deprecate creationDate (use instead createdAt)
• Added approvalExpired to TransferData and TransferEvent

Changes in this release:

• Add Tokenization Webhooks by @gcatanese in #778
• Generate Checkout models (EnhancedSchemeData) by @gcatanese in #779
• [PaymentsAPIs] Code generation: update services and models by @AdyenAutomationBot in #789
• [ManagementAPIs] Code generation: update services and models by @AdyenAutomationBot in #792
• Generate LEM, Transfers and BalancePlatform services and models by @gcatanese in #804
• Handling unknown enum values by @gcatanese in #807
• Generate Webhooks models by @gcatanese in #808
• [ManagementAPIs] Code generation: update services and models by @AdyenAutomationBot in #802

Other Changes 🖇️

• Add tests for unknown enums and attributes by @gcatanese in #775
• Add test for JSON serialisation by @gcatanese in #777
• Format running on multiple branches by @gcatanese in #784
• Update filter in format.yml by @gcatanese in #786
• Format: update Composer version by @gcatanese in #791
• [PaymentsAPIs] Code generation: update services and models by @AdyenAutomationBot in #796
• Remove leading backslash by @gcatanese in #797
• [PaymentsAPIs] Code generation: update services and models by @AdyenAutomationBot in #798
• [ManagementAPIs] Code generation: update services and models by @AdyenAutomationBot in #799
• [PaymentsAPIs] Code generation: update services and models by @AdyenAutomationBot in #803
• AcsWebhooks: remove custom fix by @gcatanese in #809
• Release v28.2.0 by @AdyenAutomationBot in #776

Full Changelog: v28.1.0...v28.2.0

Adyen PHP API Library v28.2.0

Compare

Choose a tag to compare

What's Changed

New Features 💎

• Checkout API
  • add capturePspReference and businessDayOnly attributes

Other Changes 🖇️

• chore(deps): update dependency phpunit/phpunit to v9.6.23 by @renovate in #676
• Fix warning: Implicitly marking parameter $params as nullable is deprecated by @gcatanese in #771
• PHP 8.4 compatibility by @gcatanese in #773
• Update to release-automation-action v1.4.0 by @gcatanese in #772
• Release v28.1.0 by @AdyenAutomationBot in #770

Full Changelog: v28.0.0...v28.1.0

Adyen PHP API Library v28.1.0

Compare

Choose a tag to compare

What's Changed

Breaking Changes 🛠

Checkout API

- Remove `DotpayDetails` and `GiropayDetails`
- Remove enum `PAYSAFECARD` from `PaymentDetails`

Management API

• Remove GiroPayInfo
• Remove enum PAYSHOP from PaymentMethodResponse

New Features 💎

Checkout API

* add support for `RakutenPay`
* Add `Surcharge` and `EnhancedSchemeData` (supporting Airline enhanced scheme data) in `PaymentRequest`
* Add `EnhancedSchemeData` (supporting Airline enhanced scheme data) in `PaymentCaptureRequest`
* Add `fraudRiskLevel` in `ResponseAdditionalDataCommon`
* Add enum `PAYSAFECARD` from `StoredPaymentMethodDetails`
* New Donation `type` field supporting the following values: `roundup`, `fixedAmounts`  

(Documentation)
* Added sub-merchant info:
- subMerchantPhoneNumber, subMerchantEmail
- Nested: subMerchant.subSeller[n].email, subMerchant.subSeller[n].phoneNumber
* Added bonus enum to CheckoutSessionInstallmentOption * add RequestedTestAcquirerResponseCodeinAdditionalDataCommon`

Payment Classic API

* Add `fraudRiskLevel` in `ResponseAdditionalDataCommon`

Payout API

* Add `fraudRiskLevel` in `ResponseAdditionalDataCommon`

Management API

• Add supportEmail field to the AfterpayTouchInfo
• Add enum PAYMENTDESIGNATORCONTRACT in JCBInfo
• Add PayByBankPlaidInfo
• Add enum PAYBYBANK_PLAID in PaymentMethodResponse
• Add domainSuffix field to Profile
• In SplitConfigurationRule add enums CHARGED, DEFERRED_DEBIT and PREPAID (#1457)
• Add enableGratuities to the Standalone model

LEM API

* Add  attribute `allowDebugUi` in `OnboardingLinkSettings`to  debug user interface (UI) when applicable.

Transfers API

- Added `IssuingTransactionData` with `captureCycleId` that provides the captureCycleId associated with transfer event
* Add enum `DCCPLATFORMCOMMISSION` in `PlatformPayment`
* Add enum `PENDING`in `TransferData`
* Add attribute `externalReason` in `TransferData`
* Add `scaOnApproval` attribute in `TransferReview`

Fixes ⛑️

• Remove invalid PHPDoc tag @description by @gcatanese in #764
• Correct PosSdk (PosMobileService) LIVE url by @gcatanese in #760
• Add a new configuration for HTTP client to set CURLOPT_CONNECTTIMEOUT and defines default values by @candemiralp in #756

Other Changes 🖇️

• Introduced a new HMAC troubleshooting utility for signature validation debugging (#754). The tool calculates the HMAC signature given the HMAC key and the payload:

cd tools/hmac
php tools/hmac/HMACValidatorPayments.php 1122334455AABBCCDDEEDFDFFSDS payload.json

Check the README

• Add close-issue-label flag to correctly label closed issues by @DjoykeAbyah in #750
• Add bug and feature GitHub issue form by @ayodejidev in #744
• Add nullable return types to API mustache templates by @ayodejidev in #748
• Improve PHP CI workflow by @ayodejidev in #753
• Import Guzzle utils by @szepeviktor in #720
• Vulnerability fix: set workflow permissions by @gcatanese in #765
• Generate Checkout models by @gcatanese in #761
• Generate models for LEM/Transfers/BalanceControl/BalancePlatform by @gcatanese in #763
• Generate models for Payment Classic/Payout/Management/Recurring APIs by @gcatanese in #762

Full Changelog: v27.0.0...v28.0.0

Adyen PHP API Library v28.0.0

Compare

Choose a tag to compare