Payin SDK Changelog
Every public release of the Payin SDK, with what changed and whether you need to do anything.
Every public release of @paymentlabs/paymentlabs-js is listed here, newest first. Each entry covers everything that changed since the previous public release.
Latest version: 1.36.0 (November 11, 2026). Install it with
npm install @paymentlabs/paymentlabs-js@latest.
Minor and patch releases never require changes to your integration. See the SDK Versioning and Support Policy for what each kind of release can change, and how we announce deprecations.
| Version | Released | Highlights |
|---|---|---|
| 1.36.0 | Nov 11, 2026 | The fee before the buyer pays, the payment-method-changed event, a plan step for subscriptions |
| 1.30.0 | Nov 3, 2026 | Apple Pay and Google Pay on more merchant accounts |
| 1.28.1 | Nov 2, 2026 | Compact billing address |
| 1.16.0 | Oct 15, 2026 | Address autocomplete on your own site, the sdk-error event, recurring schedules in Apple Pay and Google Pay |
| 1.10.3 | Sep 21, 2026 | Card form layout |
| 1.10.2 | Sep 21, 2026 | Live field validation, smaller package |
| 1.4.3 | Jul 10, 2026 | First 1.x release: Element API, 3D Secure, fraud detection |
| 0.x | Jul 18, 2025 – Apr 14, 2026 | End of support. 0.19.0 and earlier are not supported |
1.36.0
November 11, 2026
New
- The fee before the buyer pays. When a checkout carries a fee, the element shows the subtotal, the fee and the total above the payment methods. Each payment method can carry its own fee, so the figures follow the method the buyer selects. On a subscription they show in the plan card: what the buyer pays today, then each cycle. Apple Pay and Google Pay show the total with the fee in the wallet sheet. See Showing the fee.
hideFeeSummaryand thepayment-method-changedevent. To show the fee in your own layout, sethideFeeSummary: trueand listen topayment-method-changed. It gives the subtotal and the total of the method the buyer selects. See Showing the fee.- Pick a plan, then pay. An offer with more than one plan opens on a plan step: the buyer picks a plan, selects Continue to payment, then pays the plan's checkout. An offer with one plan goes straight to its checkout.
checkout-loadedfires when that checkout is on screen, andsubmitPayment()can only succeed after it, so keep your own pay button hidden until then. See Subscription events.
Improvements and fixes
- Google Pay works on merchant accounts whose processor issues its own gateway merchant ID.
1.30.0
November 3, 2026
New
- Apple Pay and Google Pay on more merchant accounts. Apple Pay and Google Pay can now be turned on for more merchant accounts. To turn them on for yours, ask your Payment Labs contact. Your integration does not change: the wallet buttons show when your account offers them. See Apple Pay and Google Pay.
Improvements and fixes
- If the response to a card payment is lost, or the checkout is busy with another payment attempt, the SDK now reads the checkout before it reports the result. A buyer whose payment went through is no longer told that it failed.
1.28.1
November 2, 2026
New
- Compact billing address. The billing form starts with only Address. The other address fields show once the buyer picks a suggestion or enters the address manually. To show every field from the start, set the optional
billingDetails.addressLayoutto"full". See Collecting the billing address.
Improvements and fixes
- Address suggestions work better on phones and tablets.
1.16.0
October 15, 2026
New
- Address autocomplete on your site. Billing address suggestions work wherever you host the payment element.
sdk-errorevent. Reports failures that never reach a decline, such as a payment form that didn't load, an expired session, a failed 3D Secure step, or an unavailable wallet. See SDK errors.- Recurring payments in Apple Pay and Google Pay. For subscriptions, the wallet sheet shows the buyer the schedule they agree to, so later charges in the series go through.
Improvements and fixes
- Address suggestions are available on the bank transfer form.
- The billing State list is sorted alphabetically.
- When a card can't be verified with 3D Secure, the buyer is asked to use a different card.
Deprecated
- The
payment-failedevent. It never fires; usesdk-errorinstead. It will be removed in 2.0.0.
1.10.3
September 21, 2026
Improvements and fixes
- The Security Code label stays on one line when the element is mounted in a narrow column.
1.10.2
September 21, 2026
New
- Cardholder phone for ELO cards. The billing form asks for a phone number when the buyer enters an ELO card, as ELO authentication requires. If you pass the billing address yourself, the phone is optional.
- Unconfirmed payments. While a payment is being confirmed, the buyer sees a "we are confirming your payment, please don't pay again" screen, and the
checkout-failedpayload carriesunresolved: true.
Improvements and fixes
- Card and bank transfer fields are checked as the buyer types, and the form names the field that needs fixing.
- Address suggestions are limited to the billing country the buyer selected.
- The checkout waits for a 3D Secure challenge that is still in progress.
- The 3D Secure challenge no longer shows a cancel button.
- Updated Discover card logo.
- Clearer messages for more decline reasons.
- The npm package is smaller (about 0.7 MB) and ships self-contained TypeScript types, including support for
moduleResolutionset tonode16ornodenext.
1.4.3
July 10, 2026
The first public 1.x release.
Breaking
- Widget is now Element.
createWidget()is nowcreateElement(), and the related types and CSS class follow. Action required: see Upgrading from 0.x to 1.x.
New
- 3D Secure. Card payments that need authentication show the bank's challenge in an overlay, and the checkout continues once the buyer completes it.
- Fraud detection. Device fingerprinting runs in the background and never blocks checkout.
- Phone number on bank transfers. The bank transfer form asks the buyer for a phone number.
Improvements and fixes
- Expired saved cards are handled, and card brand icons are shown.
- The payment element adapts better to small screens.
- With a single payment method, it opens automatically. With several, the buyer picks one.
- Missing iframe permissions are detected when the SDK runs inside a cross-origin iframe.
0.x
Versions 0.1.28 to 0.19.2 (July 18, 2025 to April 14, 2026) used the earlier "Widget" API. 0.x has reached end of support.
0.19.0 and earlier are not supported. They call checkout API paths that were replaced in 0.19.2.
Upgrade to the latest 1.x release.
Updated 6 days ago
