Checkoutin rajapinta ja Checkout.fi -domain suljetaan 30.6.2026

Mitä muutos tarkoittaa?

Checkoutin rajapinta (Checkout PSP API) poistuu käytöstä 30.6.2026. Tämän jälkeen maksujen käsittely onnistuu ainoastaan Paytrailin rajapintaa (Paytrail Payment API) käyttämällä.

Paytrailin rajapinta pohjautuu Checkoutin rajapintaan ja on toiminnallisesti lähes identtinen. Useimmissa integraatioissa muutos on pieni ja rajattu, mutta välttämätön, jotta maksujen vastaanottaminen voi jatkua.

Ketä muutos koskee?

Muutos koskee vain niitä verkkokauppa-alustoja ja integraatioita, joissa käytetään vielä Checkoutin rajapintaa.

Verkkokauppa-alustat

Jos käytät jotakin yleistä verkkokauppa-alustaa, asia hoituu Paytrail-lisäosan päivityksellä. Yleisimmät lisäosat löydät verkkosivuiltamme.

Voit myös ottaa yhteyttä oman verkkokauppa-alustasi tai järjestelmäsi toimittajaan ja varmistaa asian sieltä.

Suorat integraatiot

Suorien integraatioiden suhteen muutos koskee sellaisia integraatioita, jotka:

• käyttävät API endpointina osoitetta api.checkout.fi
• perustuvat Checkoutin rajapintaan
• käyttävät Checkout Finlandin aikaista dokumentaatiota.

Jos integraatiosi käyttää jo endpointia services.paytrail.com, erillisiä toimenpiteitä ei tarvita.

Mitä integraatiossa pitää muuttaa?

Siirtyminen Paytrail Payment APIin edellyttää seuraavia muutoksia:

API endpoint

• Korvaa vanha endpoint (https://api.checkout.fi) uudella endpointilla (https://services.paytrail.com)

Header-muutokset

Huomioi, että seuraavat kentät on nimetty uudelleen:

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

Lisäksi aiemmin vaadittu kenttä (deliveryDate) on Paytrailin rajapinnassa vapaaehtoinen.

Muilta osin rajapinnan rakenne ja toiminta säilyvät ennallaan.

Muuttuuko maksujen toiminta?

• Ei. Maksuprosessi, maksujen tilat sekä callback-käytännöt toimivat samalla tavalla kuin aiemmin.

• Siirtyminen Paytrailin rajapintaan mahdollistaa myös Google Payn käyttämisen. Google Pay ei ole ollut saatavilla Checkoutin rajapinnassa.

Tarvitseeko integraatio rakentaa uudelleen?

Ei tarvitse. Useimmissa tapauksissa riittää, että endpoint päivitetään ja edellä mainitut header-muutokset huomioidaan.

Mistä uusi dokumentaatio löytyy?

Ajantasainen Paytrailin dokumentaatio löytyy osoitteesta:
https://docs.paytrail.com/

Checkoutin dokumentaatiota ei enää ylläpidetä.

Mitä tapahtuu, jos muutosta ei tehdä?

Checkoutin rajapinta poistuu käytöstä 30.6.2026. Sen jälkeen maksujen luonti vanhan endpointin kautta ei enää onnistu ja integraatio lakkaa toimimasta.

Onko testausympäristö käytettävissä?

Kyllä. Paytrailin rajapinta tukee testausympäristöä, ja suosittelemme testaamaan muutokset ennen tuotantoon siirtymistä.

Mistä saan apua siirtymiseen?

Jos sinulla on kysyttävää integraation päivittämisestä, Paytrailin tekninen tuki auttaa mielellään sähköpostitse.

Jotta yhteydenottosi on mahdollisimman nopea käsitellä, tukipyynnössä on hyvä mainita:

• onko kyseessä oma integraatio vai kolmannen osapuolen toteutus
• kauppias ID.

Yhteenveto

• Paytrailin rajapinta korvaa Checkoutin rajapinnan 30.6.2026, mikä vaatii toimenpiteitä
• Rajapinnat ovat lähes identtiset, mutta huomioi seuraavat:
  • Endpoint vaihtuu
  • Kaksi header-kenttää on nimetty uudelleen.