Payment Services changelog

September 23, 2026

Payment Services v4.2.1

The Payment Services drop-in has been updated with the following changes. The drop-in moves to a new major version to reflect these additions. Existing credit card and Apple Pay integrations don’t need any changes.

New features

• Google Pay: New GooglePayBaseProps API (onButtonClick, onSuccess, onError, hidden, disabled) lets shoppers pay with Google Pay at checkout (#53).
• PayPal Buttons: New PayPalButtons container and API (onSuccess, onError, hidden, disabled, onButtonClick) let shoppers pay with PayPal directly in Edge Delivery Services checkout (#63).
• Apple Pay coupon codes: Apple Pay now supports coupon codes from the Payments JS SDK (#56).
• submitCreditCard() API: The drop-in can now handle credit card form submission internally via submitCreditCard({cartId, code}, callback), instead of requiring the host to drive it. The existing creditCardFormRef prop is deprecated but still supported (#66).

Improvements and fixes

• Accessibility: The credit card form’s loading indicator is now announced to screen readers (WCAG 4.1.3) (#62). Card number, expiration, and CVV fields keep persistent visible labels, and the selected card icon exposes aria-current (#61).
• Error handling: Guards against null errors/items in placeOrder and clearCart responses that could crash the PayPal checkout flow (#65).

July 30, 2026

Payment Services — no user-facing changes

This suite does not add user-facing Payment Services changes beyond the pinned version.

June 10, 2026

Payment Services v3.1.2

Infrastructure

• Node.js 22 LTS: The package now builds and distributes using Node.js 22 LTS. The engines.node constraint has been removed as this drop-in targets browser environments exclusively.

April 30, 2026

Payment Services v3.1.0

The Payment Services drop-in has been updated with the following changes:

• Alternative Payment Methods (APM): APM is now included in the list of supported payment methods, giving shoppers more payment options at checkout (#44).
• Reliable promise rejection: Promises are now rejected correctly even when no error handler is provided, preventing silent failures in integrations that do not define an onError callback (#38).

February 17, 2026

Payment Services v3.0.1

The Payment Services drop-in has been updated with the following changes:

• Error handler resilience - Promises are now properly rejected even when an error handler is not defined, preventing silent failures ( #38 ).

January 8, 2026

Payment Services v3.0.0

Major version upgrade for suite alignment. The Payment Services drop-in has been updated to include the following changes:

• Revised Adobe Commerce Drop-in License Agreement - Updated license agreement to current terms. Drop-ins are now exclusively licensed for Adobe Commerce as a Cloud Service (ACCS) and Adobe Commerce Optimizer (ACO). Use on on-premise or Platform-as-a-Service (PaaS) deployments is not permitted under the license agreement ( #37 ).

November 6, 2025

Payment Services v2.0.1

• Updated @adobe-commerce/payment-services-sdk dependency from pre-release 0.4.1-alpha.3 to final release 0.4.1.

November 5, 2025

Payment Services v2.0.0

• Breaking change: added mandatory apiUrl and getCustomerToken parameters to drop-in initialization configuration.
• Removed the mandatory apiUrl and getCustomerToken parameters from the CreditCard container.
• Added new payment-services/initialized/$location events to indicate payment method availability by ‘location’.
• Introduced a new ApplePay container with support for Apple Pay payments from both checkout and product detail pages.
• The name and message of errors passed to the onError callback of the CreditCard and ApplePay containers are now localized.
• The onSuccess callback for both the CreditCard and ApplePay containers now receives the cart ID of the completed payment.
• The promise returned by the creditCardFormRef’s submit() function is now guaranteed to reject (with a localized error) if the credit card payment fails.
• The Credit Card form no longer automatically submits when pressing the Enter key.

October 29, 2025

Payment Services v1.0.3

• Removed a redundant call to setPaymentMethodOnCart mutation that was failing for Credit Card checkouts in storefronts connected to Adobe Commerce Cloud Service (ACCS) due to an Adobe Commerce Cloud Service platform issue (internal ticket CCSAAS-3786).

October 14, 2025

Payment Services v1.0.2

• PayPal Fastlane code: Added FASTLANE payment method code to PaymentMethodCode enum.