Adyen .NET API Library v32.2.1

What's Changed

Fixes ⛑️

• Fix Parsing a notification request item breaks starting at v30 #1199 by @Kwok-he-Chu

Other Changes 🖇️

• Release v32.2.1 by @AdyenAutomationBot in #1201

Full Changelog: v32.2.0...v32.2.1

Adyen .NET API Library v32.2.0

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.

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

Checkout API

• Add support for UPI QR Code
• In UpiIntentDetails add attribute billingSequenceNumber
• In UpiCollectDetails make attribute billingSequenceNumber optional

PRs

• Add support for UPI QR by @gcatanese in #1198
• LEM v4 by @gcatanese in #1197
• Add @Adyen/api-library-maintainers to CODEOWNERS by @gcatanese in #1194
• Release v32.2.0 by @AdyenAutomationBot in #1195

Full Changelog: v32.1.2...v32.2.0

Adyen .NET API Library v32.1.2

What's Changed

BalancePlatform webhooks

Add dataReview enum value to VerificationError and VerificationErrorRecursive #1189

BalancePlatform API

Add dataReview enum value to VerificationError and VerificationErrorRecursive #1189

Other Changes 🖇️

• Set workflow permissions by @gcatanese in #1184
• Release v32.1.2 by @AdyenAutomationBot in #1185

Full Changelog: v32.1.1...v32.1.2

Adyen .net API Library v32.1.1

Fixes ⛑️

• Checkout API

  • Add Card EncryptedPassword attribute by @gcatanese in #1181

• Terminal API

  • Add ScanBarcodeResult event type by @gcatanese in #1182

Other Changes 🖇️

• Update README.md by @kristianmzmz in #1179
• Release v32.1.1 by @AdyenAutomationBot in #1183

What's Changed

New Contributors

• @kristianmzmz made their first contribution in #1179

Full Changelog: v32.1.0...v32.1.1

Adyen .NET API Library v32.1.0

What's Changed

Updated new models in .NET library

Checkout API

New changes

• Added additionalData, payments, and reference fields to SessionResultResponse
• Added enhancedSchemeData to PaymentAmountUpdateRequest, PaymentCancelRequest, and PaymentRefundRequest
• Added promoted field PaymentMethod
• Added attributes browserInfo, shopperEmail, shopperIP and telephoneNumber in PaymentMethodRequest
• Added capturePspReference to PaymentRefundRequest
• In SessionResultResponse add attributes:
  * payments to provide a list of all authorised payments done for this session
  * reference to provide the unique reference in the original /sessions request
  * additionalData to provide additional information about the payment
  * *Pix: Added businessDayOnly to PixRecurring

Fix

• Riverty Details: Added subtype-field to RivertyDetails

New Payment Methods:

• Added payme and payme_pos to the list of PaymentDetails enum values

LegalEntityManagement API

• In AdditionalBankIdentification added new enums auBsbCode and caRoutingNumber
• Add new enum value KycOnInvite in AcceptTermsOfServiceResponse, CalculateTermsOfServiceStatusResponse, GetTermsOfServiceDocumentRequest, GetTermsOfServiceDocumentResponseandTermsOfServiceAcceptanceInfo`
• In FinancialReport make attribute dateOfFinancialData optional

Transaction Webhooks

• Added threeDSecure in IssuedCard class

ACS Webhooks

• In RelayedAuthenticationRequest added new attributes threeDSRequestorAppURL, environment, timestamp, type

Transfers API

• In AdditionalBankIdentification add new enum values auBsbCode and caRoutingNumber

Transfers Webhooks

• In AdditionalBankIdentification add new enum values auBsbCode and caRoutingNumber

---

Other Updates and Improvements

• 3D Secure 2 Authentication Flows: Clarified documentation for authenticationOnly and threeDSAuthenticationOnly parameters across multiple API requests, emphasizing their role in triggering the authentication-only flow.

• Shopper Contact Information for 3D Secure 2:
  The following fields are now marked as required for Visa and JCB 3D Secure 2

  • shopperEmail marked is required, if telephoneNumber is not provided.
  • shopperIP is marked as required, if shopperEmail is not provided.
  • telephoneNumber is now marked required, if shopperEmail is not provided.
    We've updated the following classes to reflect this:BalanceCheckRequest, CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, DonationPaymentRequest, PaymentLinkRequest, PaymentLinkResponse, PaymentMethodsRequest, and PaymentRequest.

• The recommended maximum length for returnUrl in CreateCheckoutSessionRequest, CreateCheckoutSessionResponse, DonationPaymentRequest, and PaymentRequest is now 1024 characters.

• Updated the description of origin in DonationPaymentRequest and PaymentRequest specifying that it should be the origin URL of the page rendering the Drop-in/Component, without subdirectories or trailing slashes.

• Updated description for addrMatch (3D Secure) in ThreeDS2RequestData and ThreeDS2RequestFields, dataOnly in ThreeDSRequestData (now explicitly for data-only flow), and nativeThreeDS in ThreeDSRequestData (clarifying potential fallback to redirect flow).

New Features 💎

• Generate Checkout models by @gcatanese in #1164
• Generate AcsWebhooks models by @gcatanese in #1166
• Generate LEM models by @gcatanese in #1167
• Generate Transaction webhooks by @gcatanese in #1168
• Transfers: Add auBsbCode and caRoutingNumber by @gcatanese in #1169
• Add new Checkout models to .NET library by @Kwok-he-Chu in #1173

Other Changes 🖇️

• Test handling of new response attributes by @gcatanese in #1171
• Release v32.1.0 by @AdyenAutomationBot in #1165

Full Changelog: v32.0.1...v32.1.0

Adyen .net API Library v32.0.1

What's Changed

New Features 💎

• Terminal API

  • Add new Event Types NetworkConnected and NetworkDisconnected #1153

• Management API

  • Add FundingSourceEnum new values prepaid, deferred_debit and charged #1161

Fixes ⛑️

• Use --skip-duplicate to ignore uploading the .symbols.nupkg package when publishing to NuGet by @Kwok-he-Chu in #1151
• Populate ApplicationName in UserAgent when not null by @Kwok-he-Chu in #1147
• Fix publish workflow by @Kwok-he-Chu in #1145

Other Changes 🖇️

• Allow workflow_dispatch in publish.yaml by @Kwok-he-Chu in #1148
• Update publish.yml to use .NET 8.0 by @Kwok-he-Chu in #1149
• Release v32.0.1 by @AdyenAutomationBot in #1146

New Contributors

• @gcatanese made their first contribution in #1153

Full Changelog: v32.0.0...v32.0.1

Adyen .net API Library v32.0.0

What's Changed

.NET 8.0 Upgrade [!]

The Adyen .NET library has been upgrade to .NET 8.0. #1141

• Changes to HttpClient

  • Developers can now set Timeout in the HttpClient, or configure the SocketConnection itself by setting the ConnectTimeout, PooledConnectionLifetime, PooledConnectionIdleTimeoutandMaxConnectionsPerServer` respectively.
  • .NET library now uses SocketsHttpHandler in .NET6+ for better performance, but default to HttpClientHandler in older versions of .NET

• .NET 8.0 upgrade

  • The language LangVersion of C# has been updated to 12
  • Nullable property is set to disabled:
    • The <Nullable> feature has been explicitly disabled, ensuring backward compatibility and getting rid of a bunch of warnings until the adyen-sdk-generator gets upgraded.
  • <ImplicitUsings> property is set to enabled
    • Due to reserved keywords such as System.Environment, some classes that require Adyen.Environment will have namespace conflicts due to global usings. I have addressed this by importing the namespaces manually
  • Tagged the Adyen.Test & Adyen.IntegrationTest as a "TestProject"

Breaking Changes

• Configuration Webhooks
  • Added Pending status to SweepConfigurationV2 #1139
• Transfers API:
  • Added ChargebackRemainder enum to TransferEvent, TransferData and Transfer models #1137
  • Added Pending enum to TransferEvent, TransferData #1137
• TransferWebhooks:
  • Added ChargebackRemainder to the PlatformPayment model #1137
  • Added Pending enum to TransferEvent, TransferData #1137
• AcsWebhooks:
  • Corrected incorrect enum values in ChallengeInfo. While the API remains unchanged, the enum values were previously incorrect and have been updated accordingly. #1135
    • Before: OTP_SMS
    • After: PWD_OTP_PHONE_FL - OTP flow via SMS
  • Before: OOB
  • After: OOB_TRIGGER_FL - Out-of-band trigger flow
• Checkout API
  • Dotpay: Removed the DotpayDetails class and all related references in CheckoutPaymentMethod and test files. Direct support for Dotpay is deprecated #1133
  • Giropay: Removed the GiropayDetails class and all related references in CheckoutPaymentMethod and test files. Direct support for Giropay is deprecated #1133
  • Paysafecard (from PaymentDetails TypeEnum): Removed Paysafecard from the TypeEnum in the PaymentDetails model #1133
  • Added Bonus enum member to the PlansEnum in CheckoutSessionInstallmentOption and Installments #1133
• Payments API
  • Added Bonus enum member to the PlansEnum Installments.PlanEnum #1133

New Changes

Updated Balanceplatform Webhooks, LegalEntity Management API, and Payouts.

Legal Entity Management (LEM) API

• Added AllowDebugUi boolean field to assist in diagnosing and resolving user onboarding issues #1139
• Added ValidTo (datetime) field to indicate when the Terms of Service was accepted #1139

Payouts

• Added FraudRiskLevelEnum to ResponseAdditionalDataCommon in the Payout model #1139

Configuration Webhooks

• Added ReplaceById and ReplacementOfId fields to ConfigurationWebhooks.PaymentInstrument #1139

Dispute Webhooks

• Added Duplicate enum value to DisputeEventNotifcation #1139

Transaction Webhooks

• Added ChargebackRemainder enum to PlatformPayment #1139

Transfers API

• Added IssuingTransactionData, TransferReview models #1137

TransferWebhooks

• Added IssuingTransactionData and TransferReview model #1137

AcsWebhooks

• Added PWD_OTP_EMAIL_FL - OTP flow via Email #1135

Checkout API

• [New] Rakuten Pay: Added support for Rakuten Pay as a payment method - RakutenPayDetails #1133
• Added email and phone number fields to AdditionalDataCommon and AdditionalDataSubMerchant #1133
  • Added SubMerchantEmail and SubMerchantPhoneNumber fields to AdditionalDataCommon
  • Added SubMerchantSubSellerSubSellerNrEmail and SubMerchantSubSellerSubSellerNrPhoneNumber fields to AdditionalDataSubMerchant
• Added RequestedTestAcquirerResponseCode to AdditionalDataCommon to facilitate testing scenarios for specific acquirer responses #1133
• Added EnhancedSchemeData property to PaymentRequest and PaymentCaptureRequest #1133
• Added EncryptedCard property to PaymentMethodToStore to allow storing encrypted card details. #1133
• Added the FraudRiskLevel enum and property to ResponseAdditionalDataCommon to indicate the risk level of a payment (e.g. VeryLow, Low, Medium, High, and VeryHigh) #1133
• Added Surcharge - This contains the surcharge amount to apply to the transaction, in minor units.

Payments API

• Added RequestedTestAcquirerResponseCode to AdditionalDataCommon to facilitate testing scenarios for specific acquirer responses #1133
• Added subMerchantEmail and subMerchantPhoneNumber fields to AdditionalDataCommon for providing more complete sub-merchant contact information when processing transactions. #1133
• Added subMerchantSubSellerSubSellerNrEmail and subMerchantSubSellerSubSellerNrPhoneNumber to AdditionalDataSubMerchant #1133
• Added the FraudRiskLevel enum and property to ResponseAdditionalDataCommon to indicate the risk level of a payment (e.g. VeryLow, Low, Medium, High, and VeryHigh) #1133
• Updated Shopper Statement Localization in Japan - The description for the localizedShopperStatement field in PaymentRequest, PaymentRequest3d, and PaymentRequest3ds2 has been updated to include support for the ja-Hani character set and JCB cards for payments in Japan #1133

Config

• ConnectTimeout (for establishing the HTTP connection) and Timeout (e.g. the time required to send the request and receive the response) are now separate configurable values in Config

Bug fixes

TerminalAPI Model

• Change diagnosis response to allow null PrinterStatus, which can be returned from devices which lack a printer.

Checkout API

• Updated FraudRiskLevelEnum in Adyen/Model/Payment/ResponseAdditionalDataCommon, Adyen/Model/Checkout/ResponseAdditionalDataCommon and Adyen/Model/Payout/ResponseAdditionalDataCommon to use the following enum values: #1142
  • veryLow
  • low
  • medium
  • high
  • veryhigh

---

Breaking Changes PRs 🛠

• Update Balanceplatform Webhooks, LegalEntity Management API, and Payouts by @Kwok-he-Chu in #1139
• Update Transfers API & TransferWebhooks by @Kwok-he-Chu in #1137
• Updated AcsWebhooks.ChallengeInfo to include PWD_OTP_PHONE_FL, OOB_TRIGGER_FL and PWD_OTP_EMAIL_FL by @Kwok-he-Chu in #1135
• Update checkout-api models and remove giropay and dotpay by @Kwok-he-Chu in #1133

Fixes ⛑️

• Update setters for timers and upgrade dependencies by @Kwok-he-Chu in #1143

Other Changes 🖇️

• Add close-issue-label flag to correctly label closed issues by @DjoykeAbyah in #1122
• Improve GitHub CI workflow by @ayodejidev in #1126
• Change POIStatus.PrinterStatus to be nullable by @peterwishart in https...

Adyen .net API Library v31.0.0

What's Changed

Breaking Changes 🛠

• Checkout:
  • In PaymentDetails added pix Enum, changing the subsequent Enum integer value.
• Management:
  • In AndroidApp removed status string.
  • In MeApiCredential removed associatedMerchantAccounts.
  • In PaymentMethodResponse and PaymentMethodSetupInfo added Ach, AlipayWap, EftDirectdebitCA and Payto Enum` changing the subsequent Enum integer value.
• ManagementWebhooks:
  • In PaymentMethodRequestRemovedNotificationRequest changed paymentMethod.requestRemoved to paymentMethodRequest.removed.
  • In PaymentMethodScheduledForRemovalNotificationRequest changed paymentMethod.requestScheduledForRemoval to paymentMethodRequest.scheduledForRemoval.
• TransactionWebhooks:
  • In PlatformPayment added DCCPlatformCommission Enum, Enum, changing the subsequent Enum integer value.
• TransferWebhooks:
  • In PlatformPayment added DCCPlatformCommission Enum, Enum, changing the subsequent Enum integer value.
• Transfers:
  • In PlatformPayment added DCCPlatformCommission Enum, Enum, changing the subsequent Enum integer value.

Feature 💎

• AcsWebhooks:

  • Added AuthenticationDecision, Purchase, RelayedAuthenticationRequest, RelayedAuthenticationResponse and ServiceError class.

• Checkout:

  • In AchDetails added AccountHolderTypeEnum.
  • In CheckoutPaymentMethod added PixDetails to initialize new instance of CheckoutPaymentMethod with PixDetails class.
  • Added PixDetails and PixRecurring class.
  • In ResponseAdditionalDataCommon added TokenizationStoreOperationTypeEnum, TokenizationShopperReference, TokenizationStoreOperationType and TokenizationStoredPaymentMethodId.

• Management:

  • Added AffirmInfo and PayToInfo class.
  • In AndroidApp added StatusEnum.
  • In PaymentMethod added Affirm, EftDirectdebitCA and Payto.
  • In Surcharge added ExcludeGratuityFromSurcharge.
  • In UpdatePaymentMethodInfo added EftDirectdebitCA

• Payment:

  • In ResponseAdditionalDataCommon added TokenizationStoreOperationTypeEnum, TokenizationShopperReference, TokenizationStoreOperationType and TokenizationStoredPaymentMethodId.

• Payout:

  • In ResponseAdditionalDataCommon added TokenizationStoreOperationTypeEnum, TokenizationShopperReference, TokenizationStoreOperationType and TokenizationStoredPaymentMethodId.

• Recurring:

  • Deprecated AbstractOpenAPISchema, Address, Amount, BankAccount, Card, CreatePermitResult, CreatePermitRequest, DisablePermitRequest, DisablePermitResult, DisableRequest, DisableResult, Name, NotifyShopperResult, NotifyShopperRequest, Permit, PermitRestriction, PermitResult, Recurring, RecurringDetail, RecurringDetailWrapper, RecurringDetailsRequest, RecurringDetailsResult, ScheduleAccountUpdaterRequest, ScheduleAccountUpdaterResult, ServiceError and TokenDetails.

• TransferWebhooks:

  • Added Lodging class.
  • In MerchantPurchaseData added Lodging.

• Transfers:

  • In CapitalGrant added Failed, WrittenOff and revoked Enum.
  • Added Lodging class.
  • In MerchantPurchaseData added Lodging.

• Service:

  • Deprecated BalanceControlService.
  • Deprecated RecurringService.

Other Changes 🖇️

• Fix 1106 - Add split object for a Platform Payment Request (IPP) by @Kwok-he-Chu in #1117
• Release v31.0.0 by @AdyenAutomationBot in #1120

Full Changelog: v30.0.0...v31.0.0

Adyen .net API Library v30.0.0

Warning

This release introduces a regression in balancePlatformWebhookHandler: the correct behavior has been restored in v32.2.1

What's Changed

Breaking Changes 🛠

• BalancePlatform:
  • Removed PriorityRestriction class
  • In TransactionRuleRestrictions removed Priority

Feature 💎

• BalancePlatform:

  • Added AssociationDelegatedAuthenticationData, AssociationFinaliseRequest, AssociationFinaliseResponse, AssociationInitiateRequest, AssociationInitiateResponse class
  • Added TokenRequestorsRestriction class

• Checkout:

  • Added FastlaneData in CardDetails, CardDonations.
  • Added FastlaneDetails in CheckoutPaymentMethod
  • Added FastlaneDetails class
  • In PaymentRefundResponse added CapturePspReference

• Services:

  • BalancePlatform:
    • Deprecated GrantAccountsService and GrantOffersService
    • Added ManageSCADevicesService class

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

Fixes ⛑️

• Add NegativeBalanceCompensationWarning webhooks by @Kwok-he-Chu in #1114

Other Changes 🖇️

• Add bug and feature issue form by @ayodejidev in #1118
• Release v30.0.0 by @AdyenAutomationBot in #1115

Full Changelog: v29.0.0...v30.0.0

Adyen .net API Library v29.0.0

What's Changed

Breaking Changes ⚒️

• AcsWebhooks
  • In ChallengeInfo added 00 and 08 changing the subsequent Enum integer values
• BinLookup
  • In CostEstimateResponse removed SurchargeType
• TransferWebhooks
  • In TransferReview removed ScanOnApprovalEnum
• Transfers
  • In TransferReview removed ScanOnApprovalEnum
• Payments:
  • In Split added TopUp changing the subsequent Enum integer values

New Features 💎

• Terminal API:

  • Add Regions support for live transactions: use an endpoint that is geographically closest to the location of your store - by @DjoykeAbyah in #1108

• LegalEntityManagement:

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

• NegativeBalanceWarningWebhooks:

  • Added Amount class.
  • Added ModelInterface class.
  • Added NegativeBalanceCompensationWarningNotificationData class.
  • Added NegativeBalanceCompensationWarningNotificationRequest class.
  • Added ObjectSerializer class.
  • Added Resource class.
  • Added ResourceReference class.


• Service/Transfers

  • In CapitalService added deprecation messages.

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

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

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

Other Changes 🖇️

• update Readme by @DjoykeAbyah in #1113
• Release v29.0.0 by @AdyenAutomationBot in #1110

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.

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