Embedded Components

Changelog

This changelog covers updates to the Payabli embedded components.

Changes for July 24, 2026

Corrected Google Pay button style accepted values

We’ve corrected the documented buttonStyle values for Google Pay in the ExpressCheckout UI component configuration reference. The accepted values are black, white, and default, with black remaining the default. This change affects the documentation only — the component’s accepted values haven’t changed.

Changes for July 10, 2026

Enhanced Apple Pay support for ExpressCheckout UI

The ExpressCheckout UI component can now support Apple Pay in third-party browsers. To enable Apple Pay in third-party browsers (like Chrome and Edge), you need to enable the crossBrowser field in the applePay config object of the ExpressCheckout UI component. You must also verify your domain with Apple Pay and ensure that your website’s CSP allows the Apple Pay SDK script to load. To learn more about enabling Apple Pay for third-party browsers, see Apple Pay compatibility

Changes for June 15, 2026

New invoiceData object for ExpressCheckout UI

We added the invoiceData object to the ExpressCheckout UI configuration. The invoiceData object allows you to create an invoice for a transaction when using the ExpressCheckout UI component. The invoiceData supports the one_time and autopay modes of the ExpressCheckout UI component. See ExpressCheckout UI for more information about the invoiceData object.

Changes for May 11, 2026

New mode field for ExpressCheckout UI

We added the mode field to the ExpressCheckout UI configuration. The mode field determines the behavior of the ExpressCheckout UI component. This field accepts three values:

  • one_time - process one-time transactions
  • autopay - sets up recurring subscriptions with a billing schedule
  • tokenization - tokenizes payment method without charging customer

Changes for April 15, 2026

Retirement of the Embedded Components Playground

Payabli’s Embedded Components Playground has been retired as of April 15th, 2026. The site at playground.payabli.com is no longer available.

Why the playground was deprecated

Third-party libraries that the Playground relied on have been deprecated. Unmaintained dependencies pose security risks. For this reason, the Playground has been retired and the site has been taken down.

Changes for March 16th, 2026

New splitFunding config for ExpressCheckout UI

We added a new splitFunding config option for the ExpressCheckout UI component. The splitFunding field receives an array of objects containing split funding instructions. See the ExpressCheckout UI configuration reference for more information.

Changes for February 17, 2026

New input field for RDC payment method in EmbeddedMethod UI

We added a new rdcAmount input field for the RDC (Remote Deposit Capture) payment method in the EmbeddedMethod UI component. The rdcAmount input field allows you to specify the amount for the RDC transaction. See the EmbeddedMethod UI configuration reference for more information.

Changes for October 6, 2025

New RDC payment method for EmbeddedMethod UI

We added the new RDC (Remote Deposit Capture) payment method to the EmbeddedMethod UI component. You can enable the RDC payment method by adding the rdc object to the EmbeddedMethod UI configuration.

See the EmbeddedMethod UI configuration reference for details on how to configure EmbeddedMethod UI with RDC.

January 28, 2025

  • Added the ability to use special characters (‘á’, ‘Á’, ‘é’, ‘É’, ‘í’, ‘Í’, ‘ó’, ‘Ó’, ‘ú’, ‘Ú’, ‘ü’, ‘Ü’, ‘ñ’, ‘Ñ’) in the embedded components. The HTML element <meta charset="UTF-8"> must be included in the <head> element. Code examples in the docs have been updated to reflect this change.
  • Fixed a bug where the embedded components would not show a card network as “not allowed” even though the card network was set to false in the configuration.

Evergreen library URL

In this release, we’ve transitioned to an evergreen library URL for production environments: https://embedded-component.payabli.com/component.js.

To give our partners time to migrate to the new evergreen library, Payabli will continue to support version 1.9.0 of the library (https://embedded.payabli.com/1.9.0/component.js) until March 31, 2025. However, we’re no longer maintaining or adding enhancements to this version.

Other enhancements

  • Added enhancements for the ExpressCheckout UI.
    • Added better custom CSS handling for some components.

October 24, 2024

We made enhancements to the embedded components to improve the tokenization process for some cards. Before, tokenization sometimes failed for cards if they weren’t being tokenized as part of a transaction. We’ve added two new keys to the tokenization request body: fallbackAuth and fallbackAuthAmount to run an authorization on cards while tokenizing them. See the configuration reference section of the embedded components docs for more details.

Enhancements

  • Added enhanced sandbox support for testing embedded components. Now, when using an embedded component in the sandbox environment, you must add data-test as a configuration variable to the script tag. For example:
    <script src="https://embedded-component-sandbox.payabli.com/component.js" data-test></script>. This configuration variable shouldn’t be used with the production library.
    • Added support for alphanumeric account holder and cardholder names in embedded components.
    • Added support for different ZIP code formats.

Bug fixes

  • Fixed an issue that caused the ACH and card forms to disappear when a user clicks on certain areas of the form. The forms now display as expected.
    • Fixed an issue with card expiration date validation.