Releases: Adyen/adyen-dotnet-api-library
Adyen .net API Library v32.0.1
What's Changed
New Features 💎
-
Terminal API
- Add new Event Types
NetworkConnected
andNetworkDisconnected
#1153
- Add new Event Types
-
Management API
- Add
FundingSourceEnum
new valuesprepaid
,deferred_debit
andcharged
#1161
- Add
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 theConnectTimeout,
PooledConnectionLifetime,
PooledConnectionIdleTimeoutand
MaxConnectionsPerServer` respectively. - .NET library now uses SocketsHttpHandler in .NET6+ for better performance, but default to
HttpClientHandler
in older versions of .NET
- Developers can now set
-
.NET 8.0 upgrade
- The language
LangVersion
of C# has been updated to12
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.
- The
<ImplicitUsings>
property is set to enabled- Due to reserved keywords such as
System.Environment
, some classes that requireAdyen.Environment
will have namespace conflicts due to global usings. I have addressed this by importing the namespaces manually
- Due to reserved keywords such as
- Tagged the
Adyen.Test
&Adyen.IntegrationTest
as a "TestProject"
- The language
Breaking Changes
- Configuration Webhooks
- Added
Pending
status to SweepConfigurationV2 #1139
- Added
- Transfers API:
- TransferWebhooks:
- 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:
- Before:
OOB
- After:
OOB_TRIGGER_FL
- Out-of-band trigger flow
- Corrected incorrect enum values in
- Checkout API
- Dotpay: Removed the
DotpayDetails
class and all related references inCheckoutPaymentMethod
and test files. Direct support for Dotpay is deprecated #1133 - Giropay: Removed the
GiropayDetails
class and all related references inCheckoutPaymentMethod
and test files. Direct support for Giropay is deprecated #1133 - Paysafecard (from PaymentDetails TypeEnum): Removed
Paysafecard
from theTypeEnum
in thePaymentDetails
model #1133 - Added
Bonus
enum member to thePlansEnum
inCheckoutSessionInstallmentOption
andInstallments
#1133
- Dotpay: Removed the
- Payments API
- Added
Bonus
enum member to thePlansEnum
Installments.PlanEnum
#1133
- Added
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
andReplacementOfId
fields toConfigurationWebhooks.PaymentInstrument
#1139
Dispute Webhooks
- Added
Duplicate
enum value to DisputeEventNotifcation #1139
Transaction Webhooks
- Added
ChargebackRemainder
enum toPlatformPayment
#1139
Transfers API
- Added
IssuingTransactionData
,TransferReview
models #1137
TransferWebhooks
- Added
IssuingTransactionData
andTransferReview
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
andAdditionalDataSubMerchant
#1133- Added
SubMerchantEmail
andSubMerchantPhoneNumber
fields toAdditionalDataCommon
- Added
SubMerchantSubSellerSubSellerNrEmail
andSubMerchantSubSellerSubSellerNrPhoneNumber
fields toAdditionalDataSubMerchant
- Added
- Added
RequestedTestAcquirerResponseCode
toAdditionalDataCommon
to facilitate testing scenarios for specific acquirer responses #1133 - Added
EnhancedSchemeData
property toPaymentRequest
andPaymentCaptureRequest
#1133 - Added
EncryptedCard
property toPaymentMethodToStore
to allow storing encrypted card details. #1133 - Added the
FraudRiskLevel
enum and property toResponseAdditionalDataCommon
to indicate the risk level of a payment (e.g.VeryLow
,Low
,Medium
,High
, andVeryHigh
) #1133 - Added
Surcharge
- This contains the surcharge amount to apply to the transaction, in minor units.
Payments API
- Added
RequestedTestAcquirerResponseCode
toAdditionalDataCommon
to facilitate testing scenarios for specific acquirer responses #1133 - Added
subMerchantEmail
andsubMerchantPhoneNumber
fields toAdditionalDataCommon
for providing more complete sub-merchant contact information when processing transactions. #1133 - Added
subMerchantSubSellerSubSellerNrEmail
andsubMerchantSubSellerSubSellerNrPhoneNumber
toAdditionalDataSubMerchant
#1133 - Added the
FraudRiskLevel
enum and property toResponseAdditionalDataCommon
to indicate the risk level of a payment (e.g.VeryLow
,Low
,Medium
,High
, andVeryHigh
) #1133 - Updated Shopper Statement Localization in Japan - The description for the
localizedShopperStatement
field inPaymentRequest
,PaymentRequest3d
, andPaymentRequest3ds2
has been updated to include support for theja-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
inAdyen/Model/Payment/ResponseAdditionalDataCommon
,Adyen/Model/Checkout/ResponseAdditionalDataCommon
andAdyen/Model/Payout/ResponseAdditionalDataCommon
to use the following enum values: #1142veryLow
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
addedpix
Enum, changing the subsequent Enum integer value.
- In
- Management:
- In
AndroidApp
removedstatus
string. - In
MeApiCredential
removedassociatedMerchantAccounts
. - In
PaymentMethodResponse
andPaymentMethodSetupInfo
addedAch
,AlipayWap
,EftDirectdebitCA
andPayto
Enum` changing the subsequent Enum integer value.
- In
- ManagementWebhooks:
- In
PaymentMethodRequestRemovedNotificationRequest
changedpaymentMethod.requestRemoved
topaymentMethodRequest.removed
. - In
PaymentMethodScheduledForRemovalNotificationRequest
changedpaymentMethod.requestScheduledForRemoval
topaymentMethodRequest.scheduledForRemoval
.
- In
- TransactionWebhooks:
- In
PlatformPayment
addedDCCPlatformCommission
Enum, Enum, changing the subsequent Enum integer value.
- In
- TransferWebhooks:
- In
PlatformPayment
addedDCCPlatformCommission
Enum, Enum, changing the subsequent Enum integer value.
- In
- Transfers:
- In
PlatformPayment
addedDCCPlatformCommission
Enum, Enum, changing the subsequent Enum integer value.
- In
Feature 💎
-
AcsWebhooks:
- Added
AuthenticationDecision
,Purchase
,RelayedAuthenticationRequest
,RelayedAuthenticationResponse
andServiceError
class.
- Added
-
Checkout:
- In
AchDetails
addedAccountHolderTypeEnum
. - In
CheckoutPaymentMethod
addedPixDetails
to initialize new instance ofCheckoutPaymentMethod
withPixDetails
class. - Added
PixDetails
andPixRecurring
class. - In
ResponseAdditionalDataCommon
addedTokenizationStoreOperationTypeEnum
,TokenizationShopperReference
,TokenizationStoreOperationType
andTokenizationStoredPaymentMethodId
.
- In
-
Management:
- Added
AffirmInfo
andPayToInfo
class. - In
AndroidApp
addedStatusEnum
. - In
PaymentMethod
addedAffirm
,EftDirectdebitCA
andPayto
. - In
Surcharge
addedExcludeGratuityFromSurcharge
. - In
UpdatePaymentMethodInfo
addedEftDirectdebitCA
- Added
-
Payment:
- In
ResponseAdditionalDataCommon
addedTokenizationStoreOperationTypeEnum
,TokenizationShopperReference
,TokenizationStoreOperationType
andTokenizationStoredPaymentMethodId
.
- In
-
Payout:
- In
ResponseAdditionalDataCommon
addedTokenizationStoreOperationTypeEnum
,TokenizationShopperReference
,TokenizationStoreOperationType
andTokenizationStoredPaymentMethodId
.
- In
-
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
andTokenDetails
.
- Deprecated
-
TransferWebhooks:
- Added
Lodging
class. - In
MerchantPurchaseData
addedLodging
.
- Added
-
Transfers:
- In
CapitalGrant
addedFailed
,WrittenOff
andrevoked
Enum. - Added
Lodging
class. - In
MerchantPurchaseData
addedLodging
.
- In
-
Service:
- Deprecated
BalanceControlService
. - Deprecated
RecurringService
.
- Deprecated
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
What's Changed
Breaking Changes 🛠
- BalancePlatform:
- Removed
PriorityRestriction
class - In
TransactionRuleRestrictions
removedPriority
- Removed
Feature 💎
-
BalancePlatform:
- Added
AssociationDelegatedAuthenticationData
,AssociationFinaliseRequest
,AssociationFinaliseResponse
,AssociationInitiateRequest
, AssociationInitiateResponse class - Added
TokenRequestorsRestriction
class
- Added
-
Checkout:
- Added
FastlaneData
inCardDetails
,CardDonations
. - Added
FastlaneDetails
inCheckoutPaymentMethod
- Added
FastlaneDetails
class - In
PaymentRefundResponse
addedCapturePspReference
- Added
-
Services:
- BalancePlatform:
- Deprecated
GrantAccountsService
andGrantOffersService
- Added
ManageSCADevicesService
class
- Deprecated
- BalancePlatform:
-
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
added00
and08
changing the subsequent Enum integer values
- In
- BinLookup
- In
CostEstimateResponse
removedSurchargeType
- In
- TransferWebhooks
- In
TransferReview
removedScanOnApprovalEnum
- In
- Transfers
- In
TransferReview
removedScanOnApprovalEnum
- In
- Payments:
- In
Split
addedTopUp
changing the subsequent Enum integer values
- In
New Features 💎
-
LegalEntityManagement:
- Added
FinancialReport
class. - In
LegalEntityAssociation
addednominee
- In
Organization
andSoleProprietorship
addedfinancialReports
- Added
-
NegativeBalanceWarningWebhooks:
- Added
Amount
class. - Added
ModelInterface
class. - Added
NegativeBalanceCompensationWarningNotificationData
class. - Added
NegativeBalanceCompensationWarningNotificationRequest
class. - Added
ObjectSerializer
class. - Added
Resource
class. - Added
ResourceReference
class.
- Added
-
Service/Transfers
- In
CapitalService
added deprecation messages.
- In
-
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 🖇️
- Add regional endpoint functionalities by @DjoykeAbyah in #1108
- 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 fieldsTerminalStatus
tolastActivityAt
anddata.AssignmentStatus
.
Note that your API-credentials requires the following permission:Management API — Terminal actions read
.
Full Changelog: v28.0.0...v29.0.0
Adyen .net API Library v28.0.0
What's Changed
Breaking Changes 🛠
- Checkout:
- In
AdditionalDataAirline
changedairlinePassengerTelephoneNumber
toairlinePassengerPhoneNumber
- In
PaymentDetails
removedAffirm
enum , altering subsequent enum integer values - In
Split
addedTopUp
enum, altering subsequent enum integer values
- In
- Payment:
- In
AdditionalDataAirline
changedairlinePassengerTelephoneNumber
toairlinePassengerPhoneNumber
- In
💎 Features
- Checkout:
- Added
AffirmDetails
class - In
CheckoutPaymentMethod
addedAffirmDetails
andPayPayDetails
- Added
PayPayDetails
class
- Added
- Code generation: update services and models by @AdyenAutomationBot in #1104
Other Changes 🖇️
- Release v28.0.0 by @AdyenAutomationBot in #1107
Full Changelog: v27.0.0...v28.0.0
Adyen .net API Library v27.0.0
What's Changed
Breaking Changes 🛠
- BalancePlatform:
- In
VerificationDeadline
,VerificationError
andVerificationErrorRecursive
addedIssueChargeCard
,IssueChargeCardCommercial
,UseChargeCard
andUseChargeCardCommercial
Enum changing subsequent enum integer values.
- In
- ConfigurationWebhooks:
- In
VerificationDeadline
,VerificationError
andVerificationErrorRecursive
added addedIssueChargeCard
,IssueChargeCardCommercial
,UseChargeCard
andUseChargeCardCommercial
Enum changing subsequent enum integer values.
- In
- LegalEntityManagement:
- In
UncorporatedPartnership
removedType
Enum - In
VerificationDeadline
,VerificationError
andVerificationErrorRecursive
added addedIssueChargeCard
,IssueChargeCardCommercial
,UseChargeCard
andUseChargeCardCommercial
Enum changing subsequent enum integer values
- In
- Update all services by @AdyenAutomationBot in #1101
Other Changes 🖇️
- BalancePlatform:
- Added
PriorityRestriction
class. - Added
Priority
inTransactionRuleRestriction
.
- Added
- Checkout:
- In
AdditionalDataCommon
addedAutoRescue
andMaxDaysToRescue
.
- In
- LegalEntityManagement:
- In
UncorporatedPartnership
addedShouldSerializeType
Boolean.
- In
- Payment:
- In
AdditionalDataCommon
addedautoRescue
andmaxDaysToRescue
.
- In
- ReportWebhooks:
- In
ReportNotificationData
addedid
.
- In
⚠️ Important⚠️ ThePosTerminalManagementService
class is effectively obsolete as all its methods are deprecated. Users are advised to migrate to the newerManagement API
for POS terminal management functionality. https://docs.adyen.com/api-explorer/Management/latest/overview- Explicitly configure ContractResolver for SaleToPOIMessage serialization by @alexander-olesiyuk-apaleo in #1095
- SaleToPOIMessageConverter fix: Added key-version and function renames for consistency by @Kwok-he-Chu in #1099
- Release v27.0.0 by @AdyenAutomationBot in #1102
New Contributors
- @alexander-olesiyuk-apaleo made their first contribution in #1095
Full Changelog: v26.1.0...v27.0.0
Adyen .net API Library v26.1.0
What's Changed
New Features 💎
- BalancePlatform
- Added
CounterpartyTypesRestriction
class. - Added
SourceAccountTypesRestriction
class - In
TransactionRuleRestrictions
addedCounterpartyTypes
andSourceAccountTypes
- Added
- ConfigurationWebhooks
- In
AccountHolderNotificationRequest
,BalanceAccountNotificationRequest
,CardOrderNotificationRequest
,PaymentNotificationRequest
andSweepConfigurationNotificationRequest
addedtimestamp
- In
- ReportWebhooks
- In
ReportNotificationRequest
addedtimestamp
- In
- Update all services by @AdyenAutomationBot in #1096
Other Changes 🖇️
- Release v26.1.0 by @AdyenAutomationBot in #1098
Full Changelog: v26.0.0...v26.1.0
Adyen .net API Library v26.0.0
What's Changed
Breaking Changes 🛠
- LegalEntityManagement
- In
LegalEntityAssociation
addedSecondaryPartner
andUnincorporatedPartnership
Enum changing subsequent enum integer values
- In
- Update all services by @AdyenAutomationBot in #1090
New Features 💎
- AcsWebhooks
AuthenticationNotificationRequest
added Timestamp
- Checkout
- In
CardDetails
addedClicktopay
enum andEncryptedCard
string - In
CardDonations
addedClicktopay
enum andEncryptedCard
string
- In
- LegalEntityManagement
- In
PCIQuestionnairesApi
addedcalculatePciStatusOfLegalEntity
andcalculatePciStatusOfLegalEntityAsync
- Added
CalculatePciStatusRequest
,CalculatePciStatusResponse
andUnincorporatedPartnership
class - In
LegalEntity
addedunincorporatedPartnership
attribute - In
LegalEntityAssociation
addedSettlorExemptionReason
attribute - In
LegalEntityInfo
andLegalEntityInfoRequiredType
addedUnincorporatedPartnership
attribute
- In
- Management
- In
TerminalConnectivityCellular
addedIccid2
attribute - In
UpdatePaymentMethodInfo
addedStoreId
attribute
- In
- ManagementWebhooks
- Added
TerminalAssignmentNotificationRequest
andTerminalAssignmentNotificationResponse
class
- Added
- Payout
- Added
ResponseAdditionalDataCard
class
- Added
- TransactionWebhooks
- In
TransactionNotificationRequestV4
addedTimestamp
attribute
- In
- TransferWebhooks
- Added
Airline
,Leg
,MerchantPurchaseData
andTransferEventEventsDataInner
class - In
TransferData
addedEventId
attribute - In
TransferEvent
addedEventsData
attribute - In
TransferNotificationRequest
addedTimestamp
attribute - In
TransferData
addedTopUp
Enum
- Added
- Transfers
- Added
Airline
,Leg
,MerchantPurchaseData
andTransferEventEventsDataInner
class - In
TransferData
addedEventId
attribute - In
TransferEvent
addedEventsData
attribute - In
Transfer
,TransferData
andTransferInfo
addedTopUp
Enum
- Added
Other Changes 🖇️
- Release v26.0.0 by @AdyenAutomationBot in #1094
Full Changelog: v25.0.0...v26.0.0
Adyen .net API Library v25.0.0
What's Changed
Breaking Changes 🛠
- LegalEntityManagement
- In
Trust
addedbusinessTrust
,charitableTrust
,discretionaryTrust
andfamilyTrust
changing subsequent enum integer values
- In
- LegalEntityManagement
- In
Trust
removedtaxAbsent
- In
- Management
- In
PaymentMethod
removedGenericPmWithTdInfo
- In
PaymentMethodResponse
addedaffirm
changing subsequent enum integer values - In
PaymentMethodSetupInfo
addedaffirm
changing subsequent enum integer values - In
PaymentMethodSetupInfo
removedGenericPmWithTdInfo
- In
- Update all services by @AdyenAutomationBot in #1088
New Features 💎
- BalancePlatform:
- In
CreateSweepConfigurationV2
,SweepConfigurationV2
andUpdateSweepConfigurationV2
addedReasonDetail
a human readable reason for disabling sweep
- In
- Checkout
- In
CheckoutPaymentMethod
added method to initialize new instance of the class withPseDetails
- Added
PseDetails
class
- In
- ConfigurationWebhooks
- In
SweepConfigurationV2
addedReasonDetail
a human readable reason for disabling sweep
- In
- DisputeWebhooks
- Added
AbstractOpenAPISchema
class - Added
Amount
class - Added
BalancePlatformNotificationResponse
class - Added
DisputeEventNotification
class - Added
DisputeNotificationRequest
class
- Added
- LegalEntityManagement
- In
OnboardingLinkSettings
addedEnforceLegalAge
to Indicate if only users above the age of 18 can be onboarded - In
PhoneNumber
addedPhoneCountryCode
the two-letter country code prefix of the phone number - In
Trust
addeddescription
to add description for the charitable trust. Only applicable for New Zealand
- In
- Management
- In
AmexInfo
andJCBinfo
added check for valid MidNumber - Added
DinersInfo
class - In
PaymentMethod
addedDinersInfo
- In
PaymentMethodSetupInfo
addedDinersInfo
- In
Other Changes 🖇️
- Release v25.0.0 by @AdyenAutomationBot in #1089
Full Changelog: v24.0.0...v25.0.0