Oire: Paytrail-maksu on onnistunut mutta tilausta ei ole

Asiakas on maksanut Paytrailissa, mutta tilausta ei löydy AI Commerce Cloudin tilauslistasta. Tämä on mahdollista, koska Paytrail-maksu ja tilauksen muodostuminen ovat kaksi eri vaihetta: pelkkä onnistunut maksu ei vielä muodosta tilausta. Maksu on siis voinut mennä läpi Paytrailin päässä, vaikka tilauksen muodostus ei ole päässyt loppuun asti verkkokaupan päässä. Tässä ohjeessa tunnistat, missä vaiheessa tilanne on jäänyt kesken, ja mitä puuttuvalle tilaukselle käytännössä tehdään.

Milloin tilaus syntyy ja miksi se voi jäädä syntymättä

Tilaus syntyy vasta siinä vaiheessa, kun Paytrailin maksun vahvistus käsitellään onnistuneesti kassan palautusvaiheessa. Tässä vaiheessa AI Commerce Cloud tarkistaa maksun tilan, allekirjoituksen, transaktiotunnuksen, summan ja alkuperäisen kassaistunnon. Jos vahvistus ei läpäise näitä tarkistuksia tai käsittely keskeytyy ennen tilauksen tallennusta, tilausta ei muodosteta lainkaan. Samaa maksutapahtumaa ei käsitellä tilaukseksi kahteen kertaan, joten saman tapahtuman myöhempi uusi vahvistus ei muodosta päällekkäistä tilausta — tämä on tarkoituksellinen suoja kaksoistilauksia vastaan, ei syy puuttuvaan tilaukseen.

Automaattinen Paytrail-tarkistus tunnistaa puuttuvat tilaukset

Järjestelmässä on erillinen Paytrail-raportin käsittelijä. Se poimii raportista maksetut tapahtumat, täsmäyttää niiden stamp-tunnisteet tallennettuihin maksuihin ja rajaa ilmoitukseen tapahtumat, joilta puuttuu tilaus. Koodi ei rajaa tarkistusta omaan 24 tunnin aikaikkunaan, vaan käsittelee Paytrailin callbackissa toimittamat raporttirivit. Kauppiaalle lähetettävän ilmoituksen otsikko on "Paytrail transactions matched (N)", jossa N on osumien määrä. Ilmoitus auttaa tunnistamaan puuttuvan tilauksen, mutta tarkistus ei muodosta tilausta automaattisesti.

Miten toimit, kun tilaus puuttuu

Varmista ensin Paytrailista, että maksu on onnistunut, ja ota talteen vähintään transaktiotunnus ja maksettu summa. Tarkista sen jälkeen, ettei tilausta todella löydy AI Commerce Cloudin tilauslistasta. Jos olet saanut sähköpostin otsikolla "Paytrail transactions matched (N)", muista että se on raportin täsmäytysilmoitus eikä merkki siitä, että järjestelmä olisi muodostanut puuttuvan tilauksen automaattisesti jälkikäteen. Kun maksu on onnistunut mutta tilausta ei ole, käsittele tapaus puuttuvana tilauksena: AI Commerce Cloud ei muodosta tilausta jälkikäteen pelkän maksetun Paytrail-tapahtuman perusteella, vaan tilaus on luotava tai maksu palautettava erikseen sovitulla tavalla.

Yhteenveto

Paytrail-maksu ja tilauksen muodostuminen ovat kaksi eri vaihetta: maksu voi onnistua Paytrailissa, vaikka tilaus ei tallennu AI Commerce Cloudiin asti. Tilaus syntyy vasta, kun maksun vahvistus käsitellään onnistuneesti kassan palautusvaiheessa, ja erillinen Paytrail-tarkistus auttaa vain tunnistamaan puuttuvat tilaukset — se ei korjaa niitä. Kun tunnistat tilanteen, ota transaktiotunnus ja summa talteen ja käsittele tapaus puuttuvana tilauksena.