Certificate change for *.pal-live.adyenpayments.com

Adyen will replace the SSL authentication certificate *.pal-live.adyenpayments.com on the live platform on June 24th 2020 between 11:00 and 12:00 CEST. Adyen will send out a system message once the certificate has been replaced successfully.

1) Will I be affected by this certificate change?

Likely this change does not affect your integration. Only merchants that do (custom) certificate pinning may need to check if the correct certificate is in their certificate trust store.

2) How can I verify if I am doing certificate pinning?

Certificate pinning is done on the merchant’s side of the integration. Therefore, merchants' certificate pinning strategies are not visible to Adyen. In case you are unsure, please check with your technical team, service administrator, or system integrator.

Merchants who do not perform certificate pinning, do not require to take action.

3) What is Adyen's recommendation on certificate validation?

By default, Adyen does not recommend to perform certificate pinning on Adyen's wildcard certificates since this may impact connectivity to Adyen's systems at the moment the certificate is rolled. In practice, for various reasons Adyen may decide to roll the certificate at different moments in time (with or without prior communication).

In case you use a custom Certificate TrustStore, merchants will have to trust the public Root Certificate Authority (CA): DigiCert Global Root G2. You can find the latest Root CA using the following links:

Similarly for the Root CA, Adyen may decide at any moment in time (with our without prior communication) to change the Root CA. In case the Root CA is not trusted, this may impact merchant connectivity to Adyen's systems. 

4) How can I check which certificate(s) is/are relevant for my integration?

You can verify the domains used for API requests to Adyen. Each certificate corresponds to the API calls performed under the domain with the same name, in this case: pal-live.adyenpayments.com. This endpoint is used for sending API requests to Adyen's systems, for example for:

  • Payment authorisations
  • Checkout
  • Modifications (such as refunds and captures)
  • Recurring / token management
  • Automatic report downloads

Usually, the endpoints can be found from your configuration. Your technical team or system integrator will be able to determine which endpoint(s) is/are being used in your integration.

5) Can I verify my connection in the test environment with Adyen?

The certificate *.adyen.com is available for testing within the test environment since January 2020. Your technical team or integrator can already start verifying your payments integration with this certificate to ensure there are no connection errors. The certificate *.adyen.com uses the same intermediate and root certificate as *.pal-live.adyenpayments.com.

For more information about endpoints, please refer to this page: Live Endpoint Structure.

For further questions regarding these certificates, please contact support (support@adyen.com).

Was this article helpful?
2 out of 2 found this helpful