No momento, esta página não está disponível em português

Release notes

Learn about the latest updates to our API, and Drop-in/Components for web, iOS, and Android.

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.

Get updates by RSS
Filter by
Checkout API
Version...
April 2025
SunMonTueWedThuFriSat
12345
6789101112
13141516171819
20212223242526
27282930
Select dates
Copy url
icon
Checkout API
New

Copy url
icon
Checkout API
New
  • The /cardDetails response now includes:
    • fundingSource: the funding source of the card, for example DEBIT, CREDIT, or PREPAID.
    • isCardCommercial: indicates if the card is a commercial card or a consumer card.

Copy url
icon
Checkout API
Fixed
  • Fixed an issue where payments with the following paymentMethod.type would break in some cases:
    • klarna
    • klarna_account
    • klarna_paynow
    • klarna_b2b
    • walley
    • walley_b2b
    • ebanking_FI
  • When blockedPaymentMethods is set to scheme, Bancontact is no longer blocked.

Copy url
icon
Checkout API
Fixed

For integrations using Drop-in or the Gift card Component:
Drop-in and the Component now correctly get the last four digits of gift cards from the API response and show them on the payment form.


Copy url
icon
Checkout API
Changed

To be compliant with regulations, the logo you can download for Visa/Dankort has been updated.


Copy url
icon
Checkout API v71
Changed
  • POST /paymentMethods:
    • To comply with EU consumer choice regulations, The name of the payment method group for cards is now Cards instead of Credit Card. When you use Drop-in with this API version, the payment method list shows this payment method group as Cards.
  • POST /payments:
    • When you make a partial payment with a gift card, and the shopper gets redirected for 3D Secure 2 authentication, the return URL includes redirectResult instead of MD and PaRes. This aligns with other 3D Secure redirect flows.
  • POST /paymentLinks:
    • When you create a payment link through the API, the setting to store payment method details in the Customer Area no longer works. Instead, you have to use the storePaymentMethodMode parameter to indicate if the details of the payment method will be stored.
    • metadata: more than 80 characters will result in a validation error.
Breaking Changes
  • POST /paymentLinks:

    • expiresAt format is now ISO 8601 with a time zone offset indicator (YYYY-MM-DDThh:mm:ss+TZD). For example, 2020-12-18T10:15:30+01:00. This format is consistent with the other timestamps that we return.

      Previously, the format included the timezone indicator Z.


Copy url
icon
Checkout API
Fixed

For the /sessions request using a stored payment method with recurringProcessingModel:CardOnFile, the shopperInteraction is now correctly set to ContAuth for subsequent payments.


Copy url
icon
Checkout API
Fixed

Fixed an issue rare internal issue that caused the /payments response to not include a resultCode.


Copy url
icon
Checkout API
New

Platforms can now book chargeback fees separately from the disputed amount, to a balance account specified in the platformChargebackLogic.costAllocationAccount field of the /payments request.


Copy url
icon
Checkout API
General
Changed

When using /sessions for Drop-in and Components, sessions are rendered invalid after the payment is completed to prevent duplicate payments.


Copy url
icon
Checkout API
Changed

When using /sessions for Drop-in and Components, it is no longer possible to have more than 5 refusals per session.


Copy url
icon
Checkout API
New

Responses to Amazon Pay POST /payments requests now contain additionalData.amazonPayToken. You can use this token as a reference, for example when troubleshooting your payment directly with Amazon Pay.


Copy url
icon
Checkout API v70

Follow the migration guide to upgrade your integration.

Breaking Changes
Changed
New
  • The /storedPaymentMethods endpoint:

    • Make a GET request to list the stored payment details for a shopper, if there are any available.
    • Make a DELETE request to disable stored payment details to stop charging a shopper with the particular recurring detail ID.
  • For /sessions and /paymentLinks requests:
    You can now include the storePaymentMethodMode parameter to set when to store the shopper's payment details.

  • For the /paymentMethods request:
    When you include the shopperReference parameter, stored payment details in the response now contain the supportedRecurringProcessingModel parameter.

  • For specific industries, such as hospitality, you can specify a reason when making a merchant-initiated transaction with stored payment details. In the /payments request, include the industryUsage parameter to specify a reason for the payment. Possible values:

    • delayedCharge.
    • noShow.
    • installment.
Removed

In the Customer Area, on the Settings > Checkout Settings page:

  • Turning on the enableRecurring toggle no longer adds the required parameters to store payment details in payment requests.
  • Turning on the enablePayout toggle no longer adds the required parameters to store payment details for payouts.
Fixed
  • For /payments and /sessions requests to make payments with stored payment details:
    When you include shopperInteraction: ContAuth and recurringProcessingModel: CardOnFile, the transactions now always get processed as CardOnFile payments.

  • If you contacted our Support Team to enable filtering payment methods based on your store, when making a /paymentMethods or /sessions request including store:
    The response now includes only payment methods available for the specified store.

  • For /paymentMethods and /sessions requests including allowedPaymentMethods with scheme and card in the array:
    The response no longer includes wallet payment methods.


Copy url
icon
Checkout API
General
New

We now accept payments made with Ukrainian cards that have been expired for up to three months, in line with the National Bank of Ukraine's recommendations.

Improved

Shopper-facing error pages now display the HTTP error code when applicable and include an updated graphic.


Copy url
icon
Checkout API
Fixed

When you enable receiving the fraudResult parameter in the /payments/details response, you now receive it for 3D Secure 2 transactions. Previously, fraudResult wasn't returned for 3D Secure 2 transactions.


Copy url
icon
Checkout API
New

Support for setting credit card installment options in the /sessions request.


Copy url
icon
Checkout API
New

Added support for partial authorization. This allows shoppers to pay for their goods with another card, if the balance of their initial card is less than the value of the goods.

Fixed

Fixed issue where the /payments and /payments/details responses incorrectly showed BCMC cards as Mastercard or Visa. The payments were correctly handled as BCMC, but the reponses had the incorrect paymentMethod.brand.


Copy url
icon
Checkout API v69

This API version is supported by our Java, NodeJS, PHP, Python, Go, and .NET libraries. We are working on updating the Ruby library.
You can find all the Adyen libraries on GitHub.

Breaking Changes

POST /payments

  • The fraudResult.results list now no longer contains the FraudCheckResult for each list item. Each list item now only contains the values of the individual risk checks. See code samples.

POST /paymentMethods

  • The format of the expiryYear returned for stored cards is now the last two digits of the year.
New

POST /sessions

POST /payments

POST /payments/details

Deprecated

Fields related to 3D Secure authentication are now grouped under the new authenticationData object. The old 3D Secure authentication fields have been deprecated.

See field mapping and code samples.


Copy url
icon
Checkout API
Fixed

Fixed an issue where some payments with redirect data couldn't be completed.


Copy url
icon
Checkout API
Improved
  • You can now use the /donations endpoint on all versions of the API.
Fixed
  • If Amazon Pay is configured as a blocked payment method, it's no longer returned in the /paymentMethods response.

Copy url
icon
Checkout API
Fixed

Fixed an issue where 3D Secure 1 redirect flow couldn't be completed.


Copy url
icon
Checkout API
Fixed

Fixed an issue where payment requests with a billing address had the stateOrProvince field populated with ZZ.


Copy url
icon
Checkout API
Fixed

Fixed an issue with Prosodie and Illicado gift cards where the balance check request always returned a Success result code.


Copy url
icon
Checkout API
Fixed

We fixed an issue where iDEAL payments could be refused if the POST /payments request included a store.


Copy url
icon
Checkout API
Improved
  • The POST /paymentMethods repsonse now contains the brands array for Bancontact.

Copy url
icon
Checkout API
Fixed
  • Fixed an issue where metadata for 3D Secure payments wasn't being returned in the CANCELLATION webhook. To get this metadata, you need to configure it as an additional setting.

Copy url
icon
Checkout API v68

This API version is supported by our Java, NodeJS, PHP, Python, Ruby, Go, and .NET libraries.
You can find all the Adyen libraries on GitHub.

Breaking Changes
  • POST /paymentMethods
    • The details array has been removed.
    • The list of issuers for payment methods like iDEAL or Dotpay, is now in the paymentMethods.issuers array.
    • For cards, if the paymentMethods.brands array has a single element, the value of the paymentMethods.name is now the brand name of the available card brand, instead of Credit Card.
  • POST /payments
  • POST /paymentLinks
    • amount.value fields now must be integers. Values like 10.5 now produce a validation error.
  • GET paymentLinks/{linkId}
    • New status value, paymentPending for payment methods that have a pending state. Previously, such states had the completed status.
  • For payment link resources, storePaymentMethodMode replaces storePaymentMethod from previous versions. The allowed values for storedPaymentMethodMode are:
    • disabled (default), the shopper's payment details are not stored.
    • enabled and shopperReference is provided, the shopper's payment details are stored.
    • askForConsent, the shopper can choose in the Pay by Link UI if they want their payment details to be stored.
New
Fixed
  • POST /paymentLinks
    • Fixed an issue where the payments page didn't show a phone number field when configured as part of requiredShopperFields.
Deprecated
Changed
  • POST /payments
    • All address fields are now optional.

Copy url
icon
Checkout API
Fixed

Fixed an issue where girocard_applepay didn't appear in the brands array for Apple Pay in the /paymentMethods response.


Copy url
icon
Checkout API
Fixed

Fixed an issue where JCB cards enabled for Apple Pay would show up as part of the paymentMethod.brands array instead of the brands array for Apple Pay. This means Web Drop-in and Components would render the Apple Pay logo as part of the Card Component.


Copy url
icon
Checkout API
New

POST /paymentLinks

  • themeId field to customize the appearance of the payment page when creating a payment link. This field is available in Checkout API v67 and later.
Fixed

All lists of countries/regions are now ordered alphabetically for each translation.


Copy url
icon
Checkout API
Fixed

We fixed an issue where a splits array included in the /payments/{paymentPspReference}/captures request was not processed correctly.


Copy url
icon
Checkout API
Improved
  • Finnish e-banking now appears as Verkkopankkimaksu in the front end when the locale is set to fi-FI.
Fixed
  • For iDEAL payments, sending emoji in the productTitle no longer causes an error during the redirect.

Copy url
icon
Checkout API
Fixed

For redirect 3D Secure payments, the amount object in the /payments/details response is now returned in the same way as for all other payments.


Copy url
icon
Checkout API
Fixed

For native 3D Secure 2 payments, the amount object in the /payments/details response is now returned in the same way as for all other payments.


Copy url
icon
Checkout API
New
Fixed
  • Fixed an issue where he /payments/details response did not contain the 3D Secure 2 fields in the additionalData object.
  • Website cross-origin isolation using COOP and COEP is now supported for Web Components 3.4.0 and above, as well as all assets on checkoutshopper.

Copy url
icon
Checkout API
Fixed

Card data decryption failures now return the correct error 174 - Unable to decrypt data, instead of 175 - Unable to parse JSON data.


Copy url
icon
Checkout API
Improved

We improved the error message that you get when including an invalid redirectResult in the /payments/details request.

Fixed

We fixed an issue where shoppers couldn't add a gift card payment to an existing order.


Copy url
icon
Checkout API
New

Checkout API v67 and above now supports the 3D Secure authentication-only flow.

Fixed

In Checkout API v64 and below, the /paymentMethods response now has supportsRecurring: true for cards.

Note that supportsRecurring was removed in Checkout API v65.


Copy url
icon
Checkout API
Fixed

When the shopper cancels a Bancontact mobile payment, you will now receive a resultCode Cancelled instead of resultCode: Unknown as before.


Copy url
icon
Checkout API
New

You can now do your captures, refunds, cancellations, reversals, and asynchronous authorisation adjustments using the Checkout API.

Have a look at the new endpoints in API Explorer:


Copy url
icon
Checkout API
Fixed

For the 3D Secure 1 flow in v67, the fraud result is now correctly returned in the /payments/details response.


Copy url
icon
Checkout API
Fixed

Fixed an issue affecting v67, where the pspReference was missing from the /payments/details response for Zip and Afterpay Touch.


Copy url
icon
Checkout API
New

Copy url
icon
Checkout API
New

For iDEAL payments in v66 and earlier, you will now get a validation error when making a /payments/details request with a redirectResult and paymentData belonging to different payments.

Fixed

For the 3D Secure redirect flow in v67, we fixed an issue where the merchantReference could be missing from the /payments/details response.


Copy url
icon
Checkout API
Fixed

Fixed an issue where adding a gift card payment to an order could result in a validation error if the request was made using one of our plugins.


Copy url
icon
Checkout API
Fixed

For the native 3D Secure 2 flow in Checkout API v67 and above, we fixed an issue where the merchantReference was not returned in the /payments/details response.


Copy url
icon
Checkout API
Fixed
  • We fixed an issue where the PayPal Component could fail when doing a zero-auth transaction.
  • For Amazon Pay, we fixed an issue where a redirect 3D Secure flow was incorrectly triggered instead of the native 3D Secure flow.

Copy url
icon
Checkout API
Improved

When making an /applePay/sessions request, you no longer receive an error when specifying a domainName with a slash (/) at the end.

Fixed

We fixed an issue where a /payments response with status 500 (Internal Server Error) could include an incorrect pspReference value.


Copy url
icon
Checkout API
Improved

For 3D Secure redirects, the loading page now has text informing the shopper that the process might take a few minutes to complete.


Copy url
icon
Checkout API
Fixed

For Checkout API v67 and above, making a /payments/details request with a URL-encoded redirectResult no longer results in a validation error.


Copy url
icon
Checkout API v67

The changes to the native 3D Secure 2 integration require at least Web Components v3.22.2 or iOS Components v4.0.0 or Android Components v4.0.0.

Breaking Changes
  • POST /payments
    • For native 3D Secure 2 authentication, the response now contains action.type: threeDS2. This replaces the threeDS2Fingerprint and threeDS2Challenge parameters used in earlier versions.
    • For redirect 3D Secure authentication, the payment is now authorized after the /payments request, when the shopper completes the authentication on the issuer's site. In previous versions, the payment was only authorized after the /payments/details request.
  • POST /payments/details
    • For native 3D Secure 2 authentication, the response can no longer contain an action object. This means that native 3D Secure 2 payments no longer require multiple /payments/details requests.
    • For redirect 3D Secure authentication, the /payments/details request is no longer required to authorize the payment, only to verify the payment result. As with other redirect payment methods, the payment is already authorized before the shopper is redirected back to your website.

      To know the payment result even when the shopper did not return to your website, listen for the AUTHORISATION webhook.

    • For redirect 3D Secure authentication, the shopper is now redirected back to you from the issuer with an HTTP GET instead of HTTP POST. The returnURL is appended with a redirectResult.
    • For redirect 3D Secure authentication, you now need to submit the redirectResult appended to the returnUrl when the shopper is redirected back to you. This replaces the MD and the PaRes parameters used in previous versions, and aligns the flow for 3D Secure redirects with all other redirects.
Known issues

The changes in this version have broken the Klarna widget integration. We are working on fixing this. In the mean time, we recommend that you don't update to this version if you're using the Klarna widget.

Removed
  • POST /payments
    • We removed the following fields that were marked as deprecated in v64:
      • details
      • paymentData
      • redirect
      • authentication
      • outputDetails
New
  • POST /paymentMethods

    • When using SEPA payments with stored details, the storedPaymentMethods field in the response now contains an object with type: sepadirectdebit:
    Copy code
    "storedPaymentMethods" : [
    {
    "ownerName" : "John Doe",
    "iban" : "GB33BUKB20201555555555",
    "id" : "9916068117659492",
    "name" : "SEPA Direct Debit",
    "supportedShopperInteractions" : [
    "ContAuth"
    ],
    "type" : "sepadirectdebit"
    }
    ]
  • POST /paymentLinks

    • requiredShopperFields to specify fields that the shopper needs to fill in before completing the payment.
    • themeId field to cusomize the appearance of the payment page when creating a payment link.
Improved
  • POST /payments
    • For payment methods with action.type: redirect, the response no longer contains paymentData.
  • POST /payments/details
    • For payment methods with action.type: redirect, you no longer need to submit paymentData.
  • POST /paymentLinks
    • Sending a shopperReference of less than three characters now results in a validation error.

Copy url
icon
Checkout API
Fixed
  • Recurring BACS Direct Debit payments no longer generate an error in the test environment.

Copy url
icon
Checkout API
Fixed

Fixes an issue where updating stored card details using an alias would not work.


Copy url
icon
Checkout API
Fixed

You no longer receive a validation error when making a valid payment request for Japanese convenience stores.


Copy url
icon
Checkout API
Fixed

Making a BLIK payment with saved payment details no longer results in an error.


Copy url
icon
Checkout API
Improved
  • We've added a button that the shopper can select in case they are not automatically redirected back to your returnUrl: Click here if you are not redirected.

Copy url
icon
Checkout API
Fixed

We fixed an issue where a /paymentMethods request with amount:0 would sometimes return an empty response.


Copy url
icon
Checkout API v66
New
  • POST /paymentMethods

    • For Apple Pay and Google Pay, the response now contains the brands array.
    • If you enabled Boleto Bancário, the response now contains paymentMethod.type: primeiropay_boleto for Boleto Bancário payments through PrimeroPay.
    • New payment method: bank transfer, with paymentMethod.type: bankTransfer_IBAN.
  • POST /payments

    • If you enabled Boleto Bancário, you can now include paymentMethod.type: primeiropay_boleto to make a payment with Boleto Bancário through PrimeroPay.
    • For bank transfers:
      • The request has paymentMethod.type: bankTransfer_IBAN.
      • The response has action.type: bankTransfer and action.paymentMethodType: bankTransfer_IBAN.
Improved
  • POST /payments

    • For redirects, except 3D Secure redirects, the response now contains details.key: redirectResult instead of details.key: payload.
    • Sending a shopperReference of less than three characters now results in a validation error:
      Copy code
      {
      "status": 422,
      "errorCode": "216",
      "message": "The shopper reference must be at least 3 characters long.",
      "errorType": "validation",
      "pspReference": "R8QTPCQ8HXSKGK82"
      }
  • POST /payments/details

    • For redirects, except 3D Secure redirects, redirectResult is now the only way to specify the redirect result in the request, replacing payload.
  • GET /paymentLinks/{linkId}

    • In the response, the status field now returns completed instead of paid to avoid confusion for payment methods that require an additional action.

Copy url
icon
Checkout API
Improved

The error messages for client key issues now contain more information about the exact cause of the problem.

Fixed

When using saved payment details to make a payment, the payment no longer fails if you don't specify a paymentMethod.type.


Copy url
icon
Checkout API
Fixed

We fixed an issue where making a non-EUR gift card payment with the order object was not working as expected.


Copy url
icon
Checkout API
New
  • POST /payments: When making partial payments with an order object and without an amount, the API now automatically sets the amount to either the gift card balance or the remainingAmount, whichever is lower.
Fixed

Copy url
icon
Checkout API
Fixed

Copy url
icon
Checkout API v65
New

Checkout API v65 is now available in API Explorer.

Changed
Removed

Copy url
icon
Checkout API
Improved

For African eWallets and eBanking, the shopperEmail, shopperName, and the telephoneNumber are no longer required parameters for the /payments request.

Fixed

We fixed an issue in v64 where valid fields could trigger a validation error.


Copy url
icon
Checkout API
Improved
  • We now accept shopperLocale with both underscores (for example en_US) and hyphens (for example en-US).

Copy url
icon
Checkout API v64
New

Checkout API v64 is now available in API Explorer.

  • All endpoints

    • If an API request contains a field that is not recognized, or if the format is not valid, we now return an error message with error code 702 instead of dropping the field. The error message contains information about why the validation failed, for example:
      Copy code
      {
      "status": 400,
      "errorCode": "702",
      "message": "Structure of PaymentRequest contains the following unmapped fields exampleErrorField",
      "errorType": "validation"
      }
  • POST /payments

    • For Boleto Bancário, when a shopperEmail is provided, we now send an email with the Boleto code to the shopper.
  • POST /paymentLinks

Improved
  • POST /payments
    • For Bancontact mobile and WeChat Pay, when making a request with paymentMethod.type bcmc_mobile_QR or wechatpayQR, the response now returns Pending instead of PresentToShopper result code. This result code is now consistent with other QR code payment methods such as BLIK and Swish.
Changed
  • POST /paymentMethods

    • The response for Amazon Pay, Apple Pay, Google Pay, and PayPal now contains a configuration object. Example for Google Pay and Apple Pay:
      Copy code
      {
      "paymentMethods":[
      {
      "configuration":{
      "merchantId":"0123456789"
      },
      "name":"Google Pay",
      "type":"paywithgoogle"
      },
      {
      "configuration": {
      "merchantDisplayName": "Merchant Name",
      "merchantIdentifier": "1000"
      },
      "name": "Apple Pay",
      "type": "applepay"
      }
      ]
      }
  • POST /payments

Deprecated
  • POST /payments

    • In the response, we have marked a number of fields as deprecated. Although they are deprecated, these fields have not yet been removed from the response and you can still use them.

      In a future version of the API, the deprecated fields will be removed and replaced by fields in the action object. We recommend that you start using the fields in the action object in the response.

      This applies to the following fields:

      Response field Solution
      authentication Use the action object instead to get the values to be used in further calls to the /payments/details endpoint. Applies to 3D Secure 2 payments.
      details [InputDetail] Use the action object instead to get all the fields needed to submit in the /payments/details call.
      outputDetails Use the action object instead to get the details that will be presented to the shopper.
      paymentData Use action.Paymentdata instead.
      redirect Use the action object instead to get information about the redirect URL for payment flows that require a redirect.

Copy url
icon
Checkout API v53
New

Checkout API v53 is now available in API Explorer.

  • POST /paymentLinks
    • The response now returns the payment link id along with all other parameters sent in the request. In previous versions, the response only contained the URL, expiry date, reference, and amount.
  • POST /payments
    • When making a request with paymentMethod.type bcmc_mobile, the response now returns both url and qrCodeData. This allows you to offer both QR code and app redirect to your shoppers.
    • We now return an error if the origin in the request contains more than 80 characters or if the URL is invalid.
Improved
  • POST /paymentMethods
    • For giropay, the bic is no longer returned in the response. If you are using Web Drop-in or Components, the front end will no longer require a BIC. When shoppers select to pay with giropay, they are now redirected to giropay's website where they can provide their BIC.
    • For Bancontact mobile, the response now only returns bcmc_mobile. This new payment method type combines the bcmc_mobile_QR and bcmc_mobile_app types from previous versions of the API.
    • If transaction rules for payment methods are set up for your account, these are now evaluated when you send a /paymentMethods request.
  • POST /paymentLinks
    • If a request is successful, the response now returns HTTP 201 instead of an HTTP 200 result code.

Copy url
icon
Checkout API
Fixed
  • When risk data are included in the payments request, this no longer results in an invalid signature calculation.

Copy url
icon
Checkout API
Fixed

Ratepay Direct Debits payments using Austrian (AT) IBANs is now working.


Copy url
icon
Checkout API
Fixed
  • onBinValue now works when a card number is pasted into the field. For more information, see Web Components 3.9.0.

Copy url
icon
Checkout API
Improved
  • We improved the /paymentMethods response when getting a list of available payment methods in Sweden. This means that if you are using Drop-in or Components and send a /paymentMethods request with countryCode: SE, you'll see the following UI improvements in line with Swedish regulations.
    • The payment method title has been changed to Card.
    • From API version v49 and later: If you support Maestro, the icon for Maestro is shown first.

Copy url
icon
Checkout API
Improved
  • If a Klarna payment request is missing invoice lines, you will now receive the following error message: No InvoiceLines provided.

Copy url
icon
Checkout API
Fixed
  • Optional shopper information sent in an Oxxo payment request will now show up in the Offers tab in your Customer Area.

Copy url
icon
Checkout API
Improved
  • We improved the reliability of 3D Secure 1 authentications after partial payments with gift cards.

Copy url
icon
Checkout API
Fixed
  • We fixed an issue where the 3D Secure 2 flow could break when receiving an unsupported screen.colorDepth value on Google Chrome v83 or v84.
  • We fixed an issue where metadata was not being sent back in the webhook event.

Copy url
icon
Checkout API
Fixed

Before this version, the /paymentMethods response would return wechatpayMiniProgram and wechatpaySDK if channel:Web. These payment methods are now only when channel:Android or channel:iOS.


Copy url
icon
Checkout API
New

To force a card transaction to use a debit funding source, you can now include in the /payments request: paymentMethod.fundingSource: debit .

Fixed
  • The /paymentMethods response now returns ACH also when the request includes amount.value: 0.
  • The deviceFingerprint is now correctly propagated for all payment methods.

Copy url
icon
Checkout API
Improved

When updating stored payment details, you can now send in an unencrypted expiration date.


Copy url
icon
Checkout API v52
Changed
  • POST /paymentMethods:
    • For giropay, the response now indicates bic as an optional field.
    • In the response, the brands array only contains scheme payment methods. Previously, tokenized cards, such as Apple Pay, were returned in the same array.
Improved
  • Native payment method (previously supported through Hosted Payment Pages (HPP)): Swish. Payment method type: swish.

Copy url
icon
Checkout API v50
Improved

Copy url
icon
Checkout API v49
New
Changed
Improved
  • Native payment method (previously supported through Hosted Payment Pages (HPP)): Oxxo. Payment method type: oxxo.

Copy url
icon
Checkout API v46
Improved
  • Native payment methods (previously supported through Hosted Payment Pages (HPP)):

Copy url
icon
Checkout API v41
Changed
Improved
  • Native payment methods (previously supported through Hosted Payment Pages (HPP)):
    • Boleto Bancário. Payment method type: boleto.
    • DOKU. Payment method type: doku.
    • Dragonpay. Payment method type: dragonpay.
    • eContext. Payment method types: econtext_atm, econtext-stores, econtext_seven_eleven, econtext_online.
    • Ratepay. Payment method type: ratepay.
New
  • For WeChatPay, support for payment method type: wechatpayMiniProgram.
  • For payment methods that require you to present a voucher to the shopper, the response now includes resultCode:presentToShopper.

Copy url
icon
Checkout API v40
New
Removed
  • For payments with wallet tokens, you no longer need to include to additionalData prefix in the additionalData object. For example, instead of additionalData.paywithgoogle.token, use paywithgoogle.token.

Copy url
icon
Checkout API v37
New
  • New payment method types for WeChatPay: wechatpaySDK, wechatpayQR, wechatpayWeb.
Changed
  • POST /payments:
    • For iDEAL, paymentMethod.issuer replaces paymentMethod.idealIssuer.
    • In the response, details.payload replaces returnUrlQueryString.