Checkout API and the Checkout.fi domain closing on 30.6.2026

What does the change mean?

The Checkout API (Checkout PSP API) will be discontinued on 30.6.2026. After that date, payments can only be processed using the Paytrail API ( Paytrail Payment API ).

The Paytrail API is based on the Checkout API and is almost identical in functionality. In most integrations, the required changes are small and clearly defined, but they are necessary to ensure that payment processing continues without interruption.

Who is affected by the change?

The change affects only e-commerce platforms and integrations that are still using the Checkout API.

E-commerce platforms

If you use a common e-commerce platform, the update is typically handled by updating the Paytrail plugin. See the list of supported plugins.

You can also contact your e-commerce platform or system provider to confirm whether any action is required.

Direct integrations

For direct integrations, the change applies to integrations that:

• use the api.checkout.fi endpoint
• are based on the Checkout API
• rely on documentation from the Checkout Finland period

If your integration already uses the services.paytrail.com endpoint, no action is required.

What needs to be changed in the integration?

Switching to the Paytrail Payment API requires the following updates.

API endpoint

• Replace the old endpoint ( https://api.checkout.fi ) with the new endpoint (https://services.paytrail.com ).

Header changes

Please note that the following header fields have been renamed:

• cof-request-id to request-id
• cof-plugin-version to platform-name

In addition, the deliveryDate field, which was previously required, is optional in the Paytrail API.

Apart from these updates, the API structure and behavior remain unchanged.

Will payment functionality change?

• No. The payment flow, payment statuses, and callback handling remain the same as before.
• Switching to the Paytrail API also enables Google Pay, which was not available when using the Checkout API.

Does the integration need to be rebuilt?

No. In most cases, updating the endpoint and applying the header changes listed above is sufficient.

Where can I find the new documentation?

The current Paytrail documentation is available at https://docs.paytrail.com/

The Checkout documentation is no longer maintained.

What happens if the change is not made?

The Checkout API will be discontinued on 30.6.2026. After that, creating payments through the old endpoint will no longer be possible, and the integration will stop working.

Is a test environment available?

Yes. The Paytrail API supports a test environment , and we recommend testing the changes before moving to production.

Where can I get help with the transition?

If you have questions about updating your integration, Paytrail’s technical support team is happy to help at tech@paytrail.com.

To help us handle your request more quickly, please include:

• whether the integration is your own or a third-party implementation
• your Merchant ID

Summary

• The Paytrail API will replace the Checkout API on 30.6.2026, and action is required
• The APIs are almost identical, but note the following changes:
  • The endpoint changes
  • Two header fields have been renamed