Skip to content

APIs / Adyen

Adyen API changes

Breaking changes, deprecations and new fields in the Adyen API, as they ship.

AdyenAdyen Checkout API v722026-09-28 · 0d81c1d412 additive

7 new response fields

LineItem.riskCategory
PaymentResponse.opi
StoredPaymentMethodResource.opi
CreateCheckoutSessionResponse.payable
PaymentDetailsResponse.opi
CheckoutForwardResponse.accountUpdate
CheckoutForwardResponse.networkToken

5 new request properties

LineItem.riskCategory
KlarnaNetworkDetails.klarnaNetworkPaymentAccountId
PaymentRequest.opi
StoredPaymentMethodRequest.opi
CreateCheckoutSessionRequest.payable

AdyenAdyen Checkout API v722026-08-04 · f0d0bd472 additive

Additive
PATCH /sessions/{sessionId} added
No action needed.
PATCH /sessions/{sessionId}
Additive
Request property financingProgram added
No action needed unless it is required.
AffirmDetails.financingProgram · reachable from 1 operation

AdyenAdyen Checkout API v722026-07-31 · 425d65d11 additive

Additive
Request property label added
No action needed unless it is required.
DonationCampaignsRequest.label · reachable from 1 operation

AdyenAdyen Checkout API v722026-07-23 · 4aba78c21 breaking

Breaking
type no longer accepts "gopay_wallet"
A value you may have hardcoded is now rejected.
PaymentDetails.type · reachable from 1 operation
Code that breaks
```
// sending "gopay_wallet" for type is now rejected
```

AdyenAdyen Checkout API v722026-07-21 · c2ff06371 breaking29 additive

Breaking
type no longer accepts "paybright"
A value you may have hardcoded is now rejected.
PaymentDetails.type · reachable from 1 operation
Code that breaks
```
// sending "paybright" for type is now rejected
```

10 new response fields

LineItem.trackingNumber
LineItem.trackingUri
LineItem.returnShippingCompany
LineItem.returnTrackingNumber
LineItem.returnTrackingUri
LineItem.shippingMethod
LineItem.shippingCompany
CardBrandDetails.healthcare
CreateCheckoutSessionResponse.thirdPartyTokenRedundancyInfo
StoredPaymentMethod.externalToken

19 new request properties

LineItem.shippingMethod
LineItem.trackingUri
LineItem.trackingNumber
LineItem.returnShippingCompany
LineItem.returnTrackingUri
LineItem.returnTrackingNumber
LineItem.shippingCompany
EnhancedSchemeData.carRental
EnhancedSchemeData.healthcare
EnhancedSchemeData.lodging
EnhancedSchemeData.temporaryServices
CreateCheckoutSessionRequest.shopperConversionId
CreateCheckoutSessionRequest.thirdPartyTokenRedundancyInfo
PaymentRequest.thirdPartyTokenRedundancyInfo
PaypalUpdateOrderRequest.deliveryAddress
PaypalUpdateOrderRequest.discountAmount
PaypalUpdateOrderRequest.shippingAmount
RivertyDetails.merchantData
KlarnaDetails.merchantData

AdyenAdyen Checkout API v722026-05-28 · 74fabab01 breaking5 additive

Breaking
holderName is now required
Partial payloads are rejected.
DirectDebitAuDetails.holderName · reachable from 1 operation
Code that breaks
```
await client.post("/…", {
  // …
  holderName: /* now required */,
});
```

3 new response fields

ResponseAdditionalDataCommon.transactionLinkId
AdditionalDataCommon.transactionLinkId
StoredPaymentMethod.cashtag

2 new request properties

AdditionalDataCommon.transactionLinkId
DirectDebitAuDetails.holderName

AdyenAdyen Checkout API v722026-05-11 · c17deb731 breaking1 additive

Breakingdirection flip: their tools call this safe
Response values are no longer constrained
The documented set of values is gone, so anything can appear. Every exhaustive switch and generated enum over this field is now incomplete.
ResponseAdditionalDataCard.cardProductId · reachable from 6 operations
Additive
Request property transactionLinkIdPaths added
No action needed unless it is required.
CheckoutForwardRequestOptions.transactionLinkIdPaths · reachable from 1 operation