Skip to main content
​
Payment ElementsSDK
v0.1.0-beta.1
First merchant beta of Overflow Payment Elements. This cut ends the 0.1.0-alpha.* series and opens the beta channel (alpha → beta → GA). Prefer this pin (or the floating CDN URL) over any alpha.Public docs and release notes also appear at docs.overflow.co/payment-elements and docs.overflow.co/changelog/overflow-payment-elements.

​
What’s included

  • Checkout and standalone elements: email, full name, phone, company name, billing and shipping address, card, bank (ACH / Plaid), Apple Pay, Google Pay, submit button, and custom fields (text, number, select, checkbox)
  • Theming via appearance (size / shadow presets and CSS variables), including runtime overflow.update({ appearance })
  • Wallets with live transaction updates and optional contact / shipping requirements where configured
  • Pinned CDN URLs for SRI (/sdk/v1/<version>/payment-elements.js) plus the floating /sdk/v1/payment-elements.js channel
  • npm loader @getoverflow/payment-elements in lockstep with this sdkVersion (types + CDN pin)

​
Changes since 0.1.0-alpha.*

Highlights from the alpha train that land in this beta, plus beta-readiness API cleanups:

​
Card

  • Optional fields.cardSecurityCode.hidden for MOTO / virtual-terminal flows (skips CVC UI and validation when hidden). Online checkout should keep the default (false).
  • Card validation FieldError.field values now match config keys: cardExpiration and cardSecurityCode (previously expiryDate and cvc). Update any error-routing that keyed on the old strings.
  • Reserved split-card identifiers (cardNumber, cardExpiry, cardCvc, cardPostalCode) are no longer part of the creatable ElementType union. Configure card inputs through overflow.card({ fields }).

​
Host / lifecycle

  • Overflow is a page-level singleton: a second new Overflow(...) returns the existing instance, logs a console.warn, and ignores the new key and options. Call overflow.destroy() before constructing again when you need a fresh instance.
  • Unmount clears theme state (size, shadows, CSS variables) so remounts do not keep stale chrome.

​
Docs / keys

  • Publishable key examples use live_pub_... (production) and test_pub_... (test / staging).
  • Curated per-version release notes ship with each sdkVersion bump and sync to the public changelog.

​
Breaking changes for alpha integrators

If you pinned an alpha and are moving to beta:
  1. Card field error keys — map expiryDate → cardExpiration and cvc → cardSecurityCode in onError / fieldErrors handlers.
  2. Split-card ElementType members — remove any create('cardNumber') (and peers); they were never creatable at runtime and are now absent from TypeScript as well.
  3. Singleton re-construct — if hot reload or key swap relied on a silent second new Overflow(...), call destroy() first or expect a console warning and the original instance.

​
Beta expectations

APIs may still change before GA (0.1.0). Pin explicitly if you need a stable hash + SRI, or use the floating URL and plan a short retest when GA ships.Known limitation: some card.update(...) option changes can reset the card fields and clear shopper-entered data. Prefer setting card options before mount, or remount deliberately after structural option changes.Report issues to your Overflow contact.GitHub release
​
Payment ElementsSDK
v0.1.0-alpha.15
Public changelog for Payment Elements releases. No intentional runtime behavior changes vs 0.1.0-alpha.14.

​
Changes

  • Payment Elements release notes now publish to the Overflow docs changelog at docs.overflow.co/payment-elements/changelog. Each SDK release appears there after the matching npm / GitHub Release ships.
  • Bundle and public API match 0.1.0-alpha.14 (including optional fields.cardSecurityCode.hidden for MOTO / virtual-terminal flows).
GitHub release
Last modified on July 29, 2026

Related topics

Welcome