Adyen Node API Library v27.0.0

Breaking Changes 🛠

• Checkout API

  • Dotpay: Removed the DotpayDetails class and all related references in CheckoutPaymentMethod and test files. Direct support for Dotpay is deprecated
  • Giropay: Removed the GiropayDetails class and all related references in CheckoutPaymentMethod and test files. Direct support for Giropay is deprecated
  • Paysafecard (from PaymentDetails TypeEnum): Removed Paysafecard from the TypeEnum in the PaymentDetails model

• Classic Payments API

  • In ResponseAdditionalDataCommon the TokenizationStoreOperationTypeEnum.AlreadyStored has been removed, and replaced by TokenizationStoreOperationTypeEnum.AlreadyExisting

• Management API

  • Remove GiroPayInfo
  • Remove enum PAYSHOP from PaymentMethodResponse

Features 💎

• Checkout API

  • Rakuten Pay: Add support for Rakuten Pay payment method - RakutenPayDetails
  • Add support for Surcharge in paymentRequest
  • Add Donation type field supporting the following values: roundup, fixedAmounts
  • Add email and phone number fields to AdditionalDataCommon and AdditionalDataSubMerchant
  • Add SubMerchantEmail and SubMerchantPhoneNumber fields to AdditionalDataCommon
  • Add SubMerchantSubSellerSubSellerNrEmail and SubMerchantSubSellerSubSellerNrPhoneNumber fields to AdditionalDataSubMerchant
  • Add RequestedTestAcquirerResponseCode to AdditionalDataCommon to facilitate testing scenarios for specific acquirer responses
  • Add EnhancedSchemeData property to PaymentRequest and PaymentCaptureRequest
  • Add EncryptedCard property to PaymentMethodToStore to allow storing encrypted card details.
  • Add the FraudRiskLevel enum and property to ResponseAdditionalDataCommon to indicate the risk level of a payment (e.g. VeryLow, Low, Medium, High, and VeryHigh)
  • Add Bonus enum member to the PlansEnum in CheckoutSessionInstallmentOption and Installments

• BalancePlatform API

  • Add Bic enum in BankIdentification
  • Add Pending enum in CreateSweepConfigurationV2
  • Add message field in InvalidField
  • Add replacedById and replacementOfId attributes in PaymentInstrument and UpdatePaymentInstrument
  • Add walletProviderAccountScore and walletProviderDeviceScore attributes in TransactionRuleRestrictions
  • Add class USInstantPayoutAddressRequirement

• Transfer API

  • Added IssuingTransactionData with captureCycleId that provides the captureCycleId associated with transfer event
  • Add enumChargebackRemainder in PlatformPayment.platformPaymentType
  • Add attribute externalReason in TransferData
  • Add enum Pending in TransferData.reason
  • Add attribute scaOnApproval in TransferReview

• Management API

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

Add support for Balance Webhooks

• Webhooks

  • Add ISSUER_COMMENTS webhook event code by @nickcarenza in #1488

• Configuration Webhooks

  • Add replacedById to PaymentInstrument

• AcsWebhooks

  • Enum value has changed:

    • Before: OTP_SMS
    • After: PWD_OTP_PHONE_FL - OTP flow via SMS

  • Enum value has changed:

    • Before: OOB
    • After: OOB_TRIGGER_FL - Out-of-band trigger flow

  • New:

  • Add PWD_OTP_EMAIL_FL - OTP flow via Email

Fixes ⛑️

• Fix null value in User-Agent HTTP header by @gcatanese in #1496
• Fix union types deserialization in Transfer webhooks by @mercury2269 in #1489

Other Changes 🖇️

• NotificationRequestItem enums: Remove legacy by @gcatanese in #1497
• Set default timeout on the HTTP client by @gcatanese in #1490
• Introduced a new HMAC troubleshooting utility for signature validation debugging (#1487). The tool calculates the HMAC signature given the HMAC key and the payload:

cd tools/hmac
npm install 

node calculateHmacPayments.js 11223344D785FBAE710E7F943F307971BB61B21281C98C9129B3D4018A57B2EB payload.json

Check the README

New Contributors

• @nickcarenza made their first contribution in #1488
• @mercury2269 made their first contribution in #1489

Full Changelog: v26.1.0...v27.0.0