Web SDK release notes

Learn about the changes and improvements to our Checkout Web SDK.

Web SDK 1.6.3 (October 22, 2018)

Toggle focus when the payment form loads

You can now choose whether the first field on the payment form gets focus when the form loads. For more information, see Settings.

Fixed issues

We fixed the following issues and bugs:

  • The Pay button was still visible after a failed payment.
  • Entering a Social Security Number on the Klarna payment form cleared the shopper's personal details.

Web SDK 1.6.2 (October 8, 2018)

Klarna and AfterPay enhancements

In this release we made a number of improvements to the placeholder text and UI in Klarna and AfterPay payment forms.

Fixed issues

We fixed the following issues and bugs:

  • The Pay button was inactive for Apple Pay payments.
  • The Pay button was inactive for Moto transactions on Internet Explorer 11.
  • security code was required for cards that do not have a CVC.

Known issue

  • The Pay button is still visible after the payment has failed. We recommend updating to Web SDK 1.6.3 or above.

Web SDK 1.6.1 (September 17, 2018)

Fixed issues

In this release we fixed the following issues and bugs:

  • Creating custom localizations would overwrite the default English (en-US) language strings.
  • The Pay button was active before the shopper entered their payment details.

We also fixed the following issues for shoppers using Internet Explorer 11:

  • Placeholder text was incorrectly displayed.
  • A "Payment failed" error message appeared after some successful payments.
  • The personal details of Swedish shoppers were not being retrieved for Klarna payments.

Known issues

  • The Pay button does not work for Apple Pay payments. If you accept Apple Pay we strongly recommend updating to Web SDK version 1.6.2 or above.
  • The Pay button is still visible after the payment has failed. We recommend updating to Web SDK 1.6.3 or above.

Web SDK 1.6.0 (September 3, 2018)

Klarna and AfterPay

If you are sending your shopper's personal details and address when you create a Payment Session, you can now remove these fields from your payment form. This simplifies the payment flow for your shoppers.

If you remove the personal details fields from your payment form, you must send the shopperNameshopperEmaildateOfBirthtelephoneNumber, and socialSecurityNumber when you create a Payment Session. If you remove the billing or delivery address, you must send the billingAddress or deliveryAddress.

To do this, pass a shopperInput object, with personalDetails, billingAddress, and deliveryAddress set to:

  • hidden: The fields will not appear on the payment form.
  • readOnly: The fields will appear on the payment form with the shopper's information, but the shopper can't edit them.
  • editable: The fields will appear on the payment form, and can be edited by the shopper. This is the default behaviour.
"configuration":{
  "shopperInput":{
    "personalDetails":"hidden",
    "billingAddress":"readOnly",
    "deliveryAddress":"editable"
  }
},

Klarna

When a Swedish shopper enters their Social Security Number, their personal details and billing address will automatically be retrieved and populated in the payment form.

Known issues

  • The Pay button does not work for Apple Pay payments. If you accept Apple Pay we strongly recommend updating to Web SDK version 1.6.2 or above.
  • The Pay button is still visible after the payment has failed. We recommend updating to Web SDK 1.6.3 or above.

Web SDK 1.5.1 (August 27, 2018)

Fixed an issue where the SDK wouldn't render when a zero-value auth request was made.

Web SDK 1.5.0 (July 13, 2018)

Localizations

  • Added the Norwegian localization. 
  • You can now create your own localizations.

For more information, see Localization.

Web SDK 1.4.0 (July 9, 2018)

  • Added support for Apple Pay.
  • Added basic support for Klarna and Afterpay, including a shopper information form with validation. For more information on how to configure this for the SDK, contact the Support Team.
  • You can now charge shoppers a fee for using specific payment methods. To enable this feature, contact the Support Team.
  • Reduced the file size of the SDK.

Web SDK 1.3.2 (July 2, 2018)

We now support one-click payments for Discover cards.

Web SDK 1.3.1 (June 18, 2018)

  • Added the Danish translation. For more information, see Localization.

  • To comply with GDPR regulations, storing card details has been changed from opt-out to opt-in. The checkbox for storing card details in the SDK is now turned off by default.

  • The Web SDK will now encrypt any cards details even if the card was not in a list of available cards. This will lead to better support of payments made with co-branded cards.

  • Fixed form validation for Bancontact.
  • Improved stability in Firefox.

Web SDK 1.3.0 (April 30, 2018)

Localization

Added the Polish translation. For more information, see Localization.

Additional payment method support

We've added support for the following payment methods:

  • WeChat Pay
  • MOLPay
  • Dotpay

Removed IE8 support

From this release, Internet Explorer 8 is no longer supported.


Migrating to Web SDK 1.3.0

As well as updating the version in the <head> of your payment page, you will need to make additional client and server-side changes when migrating to version 1.3.0.

Client-side changes

Instead of passing the complete JSON response to the Checkout SDK, pass the value of paymentSession.

For more information and a code example, see Show payment form.

Server-side changes

Make the following changes to your server-side code:

  1. Update the endpoints used to communicate with the Adyen payments platform: 
    1. replace /setup with /paymentSession.
    2. replace /verify with /payments/result.
  2. When creating a payment session, additionally pass the sdkVersion parameter, specifying the version of the SDK you are using. For more information and a code example, see Create payment session
  3. You no longer need to pass the html parameter to /paymentSession.
  4. Instead of passing the full JSON response received when creating a payment session, pass the value of paymentSession. For more information and a code example, see Create payment session

If you are using Web SDK version <1.3.0, your existing integration will continue to work.

Web SDK 1.2.3 (February 26, 2018)

The following event hooks were added:

  • onLoad - triggered when fields have loaded.
  • onConfigSuccess - triggered when field configuration is successfully completed.

For more information on how to use these hooks, see Logic.

Web SDK 1.2.1 (February 14, 2018)

The following hooks were added:

  • getDataFromSubmissionProcess - intercepts JSON data that is generated when the shopper selects Pay .
  • showProcessingAnimation - customizes how a processing payment is indicated.

For more information on how to use these hooks, see Logic.

Focus now added to first input of any payment method requiring additional data.

Web SDK 1.2.0 (November 11, 2017)

Localizations

  • Added Swedish, Traditional Chinese and Simplified Chinese localizations.
  • Translation strings and placeholders can now be customized.

For more information, see Localization.

Hide the Pay button

You can now hide the Pay button until a subsequent screen. To check if a payment method form is in a valid state, submit a call to chckt.submitPaymentForm (set to true). 

Customize rendering and behavior of payment form fields

You can configure this in the SDK using configObject. For more information, see Settings.