This page contains the release notes for Pay by Link, Checkout API, and Drop-in/Components for web, iOS, Android, React Native, and Flutter starting from 2020.
Release notes
Learn about the latest updates to our API, and Drop-in/Components for web, iOS, and Android.
- The payment page now contains a country selector. When a payment link does not contain country information, shoppers are now prompted to select their country.
For iDEAL, the shopper now gets redirected to an iDEAL-hosted page to select their issuer and finish the payment.
- Reverted the new iDeal payment flow that was released in 2 September, 2024.
- The new iDEAL payment flow where the shopper is redirected to the iDEAL payment page to select their bank and authorize the payment.
This change is reverted in a later release.
- For payment links with only one payment method that does not require additional shopper input, the shopper no longer needs to select an additional button to pay.
- You can now send your shoppers a confirmation email after they complete a payment and the payment gets authorized. The email is for customer service purposes, but it is not an official payment confirmation or receipt.
- For zero-value auth transactions, the submit button text is now Save details, and shoppers see the Details saved text after successfully submitting their payment details.
The logo no longer appears twice in the payment link email sent to your shoppers.
Shopper last names are now included in the payment link emails sent to your shoppers. Previously, only first name was used to address the recipient.
Payment method:Cash App Pay. Payment method type: cashapp.
To comply with EU consumer choice regulations, when card payment methods are available, the payment method list shows the group as Cards instead of Credit Cards.
Background images are no longer in payment links sent through email.
When configuring creation settings for payment links created through the Customer Area, you can now choose if payment links include the Service date input field.
Payments using payment links no longer include the applicationInfo
parameter.
For the /paymentLinks request to create a payment link that stores the shopper's payment details:
You must include the recurringProcessingModel parameter.
When creating a payment link in the Customer Area, you can enable storing the shopper's payment details.
In your Customer Area, go to Pay by Link > Settings and select the toggle to enable.
When creating a payment link through the Customer Area, you can now specify if you want to manually capture the payment.
When creating payment links through the Customer Area, it's now possible to add installment options when the shopper country/region is Colombia, Peru, or Ecuador.
When creating payment links through the Customer Area, it's now possible to store payment details for future payments. This setting is specific to payment links.
When creating payment links through the Customer Area, it's no longer possible to store payment details for future payments.
From 10 Oct, 2022, it's possible to store payment details when creating payment links through the Customer Area. This setting is now specific to payment links.
When you create a payment link in the Customer Area and choose a different theme than your default one, the payment link now shows the chosen theme. Previously, payment links always showed the default theme.
You can now use the Pay By Link app on iOS devices without contacting support for additional setup.
When the shopper's browser is set to a language that isn't English, the list of payment methods now shows the translated names of payment methods.
For PayPal payments that require personal details, the modal now shows up correctly after selecting the PayPal button.
For non-reusable payment links, if a card payment is refused, the shopper can try to pay again for a maximum of 5 times.
- Pay by Link now uses Web Drop-in v5.8.0.
- The settings for the payment links list are no longer being reset when reloading the page.
- In the Customer Area, on the Settings page, turning off the Enable gift card toggle now disables gift card payments.
- Balance checks for gift cards no longer fail for non-euro currencies.
On the transactions overview page in the Customer Area, you can now filter the payment links by creation source: Customer Area, API, or Pay by Link app.
When you create a payment link in the Customer Area and have one physical store, you can now clear the Store field if you don't want the payment link to be associated with that store.
If you get an error when creating a payment link in the Customer Area, you now get a PSP reference number in the error message. Adyen can use it to help you find out the cause of the error.
Fixed an issue where, when creating a payment link in the Customer Area, more than one radio button could be selected in the Link validity section.
Fixed an issue where the email notification for a 3D Secure payment could be missing the payment method.
On the Payment links page, you can now:
- Filter payment links by Payment link ID.
- Add a column for Shopper email.
Added support for Arabic.
Improved validation for Shopper reference when creating a payment link in the Customer Area.
We've added ways to customize the list of payment links, for example to show and hide fields, or rearrange columns.
- If a shopper accepts the Terms and Conditions and refreshes the page, we no longer show the modal for accepting Terms and Conditions.
- When uploading an image to a theme, we now show a loading state in the image upload component.
We fixed an issue where the payment link could have default validity, even though you had specified a custom validity when creating the payment link in the Customer Area.
Improved validation when you upload an image for a theme.
The Shopper reference field is now correctly marked as optional when you're creating a payment link in the Customer Area.
When creating a theme and uploading a background image with an unsupported format, you will now get a validation error.
If you have uploaded a brand logo, this is now used as the favicon.
- Upgraded to Web Components 4.8.0.
- If a shopper refreshes the page after an unsuccessful payment attempt, the delivery address form is no longer hidden.
- For reusable payment links, the delivery address used for the first payment is no longer being stored for the following payments.
- Pay by Link now has its own section in the Customer Area main navigation.
- Create and choose themes for the payment page when using Pay by Link:
- You can now have numbers in the card holder name.
We reverted the improvement from 23 Aug 2021 because it was causing problems for some payment methods.
If a shopper refreshes the page after entering payment details for a voucher or a redirect payment method, they now have to choose whether to continue with the payment, or to start over. This helps to prevent shoppers from making accidental duplicate payments.
- We improved the error messages for when a user creating a payment link in the Customer Area doesn't have the required permissions.
- A
merchantReference
that doesn't fit into a single line is now broken into several lines, so it will no longer exceed the payment form border. - We improved the message shown to the shopper after completing a payment that has a status of Payment pending.
For in-store Pay by Link, we fixed an issue where the result icon on the confirmation page wasn't being rendered.
- Payment links created through the Customer Area are now correctly generating recurring payment tokens.
- Fixed an issue where installments were not available for stored cards.
- If you're entering shopper details manually when creating a payment link in the Customer Area, you can now also add the shopper's first name, last name, and telephone number.
- If you are using the same merchant account for your online payments integration as well as Pay by Link, Apple Pay only appears as an available payment method for Pay by Link if you are using Adyen's Apple Pay certificate for your online payments integration.
- For voucher and bank transfer payments, we added back the Continue button which takes the shopper back to your website.
- When creating a payment link in the Customer Area, you no longer get an error when entering an Australian shopper address.
Recurring payment tokens are not generated correctly for payment links created through the Customer Area. This is fixed in the 19 July 2020 release.
- Changed the date format in the Customer Area payment links overview to be more readable.
- Fixed an issue where the
merchantReference
would not be correctly returned in the/payments/details
response during 3D Secure transactions. - Downloading the payment links CSV file from the Customer Area now works on Safari.
In the currency dropdown, we're now using the correct GHS currency code for the Ghanian cedi.
Fixed an issue in the Customer Area where you couldn't change the order for some payment methods.
You can now filter and download a CSV of the payment links you created. You can filter by:
- Merchant reference
- Status of the payment link
- How the link was created
- The user who created the link
- Creation date
- Link type
When filtering by links generated through the API, you get all the links created using Adyen's EU data center. We are working on adding the other data centers.
- When entering multiple email addresses for receiving payment updates, you can now separate them by commas.
- We improved the error message that you get when trying to get a payment link for a combination of country/region and currency for which no payment methods are available.
- Pay by Link is now using Checkout API v67 and Web Components 4.7.0.
- The address form in the Customer Area now supports addresses in Australia.
- Shoppers in Australia can now select a State when entering their billing or delivery address on the payment page.
If the user creating a payment link in the Customer Area doesn't have the right permissions, they now see an error explaining this.
We improved the positioning of the Continue button shown on a mobile screen after the shopper completes the purchase.
We fixed an issue where the payment update email did not contain the billing and the delivery address, even though the shopper had provided these.
The link creation page in the Customer Area now has a:
- Address form specific to country/region.
- Search option for the currency selection field.
Fixed an issue that caused some Blik payments to be reported as failed, even though they were successful.
We fixed an issue where shoppers could not use a gift card that didn't have enough balance for the full payment.
New supported payment method: Apple Pay
- We fixed an issue where the list of payment links in the Customer Area would return no results when using the search bar.
- When creating a payment link in the Customer Area, searching in the Store drop-down now works as expected.
Inactive payment links shown in the Customer Area can now have a Payment pending status, indicating that the final result of the payment is not yet known. Previously, such payments had a status of Completed.
All users creating in-store payment links through the Customer Area can now select the store for which to create the payment link.
When creating a payment link in the Customer Area, you can now specify fields that the shopper should fill in before completing the payment, for example name, email, or address.
Fixed an issue where shoppers paying using the inline Klarna widget integration were unable to complete payments.
Fixed an issue where canceling an Affirm payment on the website returned a Payment successful! message instead of canceling the payment.
- Fixes an issue where the shopper would be unable to enter their card details if Pay by Link was configured to only accept a single card brand.
- Added validation to check if the Terms of Service URL is a valid URL before storing it in the configuration.
- Fixes an issue where confirmation e-mails for Alipay payments were not being sent.
- Fixed an issue where selecting Back to Merchant before completing a payment on an Alipay HK payment returned a Payment Successful message instead of canceling the payment.
New supported payment method: Pix
Pay by Link is now using Checkout API v66, and Web Components v3.21.1.
When redirecting to your Terms & Conditions, we now add the shopperLocale
to the Terms & Conditions URL. For example, for Spanish you'll get: https://terms-and-conditions-url.com/?locale=es-ES
. This allows you to change the language of the Terms & Conditions based on the shopper's language.
We fixed an issue where double-clickling the Create payment link could create a duplicate payment link.
The maximum validity time for a payment link is now 70 days instead of 30 days.
We fixed an issue where Pay by Link would fail to load on Internet Explorer 11.
- We fixed an issue where the Copy link button was not working as expected on some devices or browsers.
- 3D Secure authentication no longer fails if the payment is routed from 3D Secure 2 to 3D Secure 1, for example in case of a technical error in the 3D Secure 2 flow.
When creating a payment link in the Customer Area, the Shopper locale and the Link type are now prefilled with last values that you previously selected.
We fixed an issue where additionalData.paymentLinkId
was sometimes missing from the AUTHORISATION webhook.
- Affirm is now also supported when creating payment links through the Customer Area.
- We added the support for the following shopper locales: Czech, Greek, Hungarian, Croatian, Romanian, Slovak, and Slovenian.
When creating payment links through the Customer Area, specifying a Shopper reference of less than three characters now results in a validation error.
If no payment methods are available for the amount
and countryCode
specified in the payment link, the shopper will now see an error.
The amount
specified in a payment link is now correctly validated against the limit set for your account.
- We fixed an issue with the PayPal authorisation-only flow.
- Pay by Link API: When you specified an array of
allowedPaymentMethods
, it was still possible to make payments with card types that were not specified in this array (even though they were not rendered in the UI). We have fixed this, so that it is no longer possible to make payments with card types not specified in theallowedPaymentMethods
array.
We fixed an issue where single-use payment links were creating multiple payments.
Pay by Link API: When making a /paymentLinks
request, you can now include the deliverAt
parameter.
- We fixed the Finnish translations for the terms and conditions prompt.
- Pay by Link API: We fixed an issue where payments would fail when you provided a delivery address but no billing address.
If the final status of the payment can not yet be determined, the shopper now sees a message of Pending instead of Something went wrong.
The QR code for WeChatPay is now rendering correctly.
The payment update to your email now contains the payment method used for the payment.
- We fixed an issue where redirecting back from the Swish app would start a new Swish payment.
- Pay by Link API: Specifying
cup
in theallowedPaymentMethods
or theblockedPaymentMethods
array now works as expected.
- Fixed an issue where shoppers did not get redirected correctly when using 3D Secure.
- New supported payment method: Google Pay.
- We added support for the PayPal authorisation-only flow.
- Webhook events for Pay by Link payments now include the
paymentLinkId
.
- Fixed an issue where in some cases split payment data were not retained with iDEAL payments.
- We fixed an issue where a non-reusable payment link can still be reused after paying with Klarna.
- We fixed an issue where if you upload a logo for your payment page, the favicon did not reflect the logo. Now you can see the logo on the payment page and in your browser's favicon.
- We resolved an issue where payment links can still be used even if you sent
reusable
: false in your request.
You can now see the /paymentLinks
endpoint in your Customer Area, under Accounts > API URLs.
Pay by Link now only shows one option for WeChat Pay in the payment method selection list.
The paymentLinkId
is now sent in the AUTHORISATION webhook. You can use this to reconcile payments to payment links.
- We fixed an issue where a non-reusable payment link can be used to pay multiple times when using Internet Explorer. To fix this issue, we added a no-cache header to the Pay by Link request.
- New supported payment methods: Buy now, pay later payment methods such as Klarna and Zip.
- Credit card installments
- When using Adyen for Platforms, you can now add split instructions to payment links.
- The redirect URL for Oney 3x4x payments has been shortened.
- The
countryCode
is no longer a required parameter for the/paymentLinks
request.
- The shopper can no longer make multiple payments when a single-use payment link is open in multiple tabs.
- By default, payment links can now only be used to make one successful payment. To create a reusable link, you can override the default behavior when creating the payment link.
- You can now view previously created payment links in a dashboard in your Customer Area (only for payment links created through the Customer Area).
- You'll receive an email when a payment link has successfully been paid for (only for payment links created through the Customer Area).
The payment link URL has been shortened.
We fixed an issue that didn't allow creating payment links if you only had one store ID under your merchant account.
Stored payment methods are now available for payment links created through the API.