PrestaShop

• Aktiivinen Cost+-kauppiastili
• PrestaShop 9.1 tai uudempi
• PHP 8.1 tai uudempi
• SSL/HTTPS käytössä
• Ylläpitäjän pääsy PrestaShop-hallintapaneeliin

• Aktiivinen Cost+-kauppiastili
• PrestaShop 8.x -asennus
• PHP 8.0 tai uudempi
• Ylläpitäjän pääsy PrestaShop-hallintapaneeliin
• MySQL 5.4 tai uudempi

• Aktiivinen Cost+-kauppiastili
• PrestaShop 1.7.x -asennus
• PHP 5.4 tai uudempi
• Ylläpitäjän pääsy PrestaShop-hallintapaneeliin
• MySQL 5.4 tai uudempi

• Aktiivinen Cost+-kauppiastili
• PrestaShop 1.6.1.x -asennus
• PHP 5.6 tai uudempi (cURL- ja OpenSSL-laajennuksilla)
• SSL/HTTPS käytössä kaupassa
• Ylläpitäjän pääsy PrestaShop-hallintapaneeliin

Lataa moduuli GitHubista.

Tapa A: Lataus hallintapaneelin kautta (suositeltava)

1. Siirry hallintapaneelissa kohtaan Modules → Module Manager
2. Napsauta Upload a module
3. Vedä ja pudota ZIP-tiedosto tai valitse se manuaalisesti
4. Odota asennuksen valmistumista
5. Hae "NoPayn" ja napsauta Configure

Tapa B: Manuaalinen lataus

1. Kopioi nopaynpayment/-kansio PrestaShop-asennuksesi modules/-hakemistoon
2. Siirry kohtaan Modules → Module Manager
3. Hae "NoPayn" ja napsauta Install
4. Napsauta Configure avataksesi asetukset

Lataa moduuli GitHubista.

Tapa A: Lataus hallintapaneelin kautta (suositeltava)

1. Siirry hallintapaneelissa kohtaan Improve > Module Manager
2. Napsauta Upload a module
3. Vedä ja pudota ZIP-tiedosto tai valitse se manuaalisesti
4. Odota asennuksen valmistumista
5. Selaa alas "Other"-osioon ja napsauta Configure Cost+:n alla

Tapa B: Manuaalinen lataus (S)FTP:llä

1. Pura ladattu ZIP-tiedosto
2. SFTP-ohjelmalla (esim. FileZilla, WinSCP) lataa kaikki kansiot PrestaShop-asennuksesi /modules/-hakemistoon
3. Siirry kohtaan Improve > Modules > Module Catalog
4. Hae "Cost+" -- tarkista Uninstalled Modules -välilehti tarvittaessa
5. Napsauta Install

Lataa moduuli GitHubista.

Tapa A: Lataus hallintapaneelin kautta (suositeltava)

1. Siirry hallintapaneelissa kohtaan Improve > Module Manager
2. Napsauta Upload a module
3. Vedä ja pudota ZIP-tiedosto tai valitse se manuaalisesti
4. Odota asennuksen valmistumista
5. Selaa alas "Other"-osioon ja napsauta Configure Cost+:n alla

Tapa B: Manuaalinen lataus (S)FTP:llä

1. Pura ladattu ZIP-tiedosto
2. SFTP-ohjelmalla (esim. FileZilla, WinSCP) lataa kaikki kansiot PrestaShop-asennuksesi /modules/-hakemistoon
3. Siirry kohtaan Modules > Module Manager
4. Hae "Cost+" -- tarkista Uninstalled Modules -välilehti tarvittaessa
5. Napsauta Install

Lataa moduuli GitHubista.

Tapa A: Lataus hallintapaneelin kautta (suositeltava)

1. Lataa costpluspayment.zip GitHub Releases -sivulta
2. Siirry PrestaShop-hallintapaneelissa kohtaan Modules and Services
3. Napsauta Add a new module
4. Lataa ZIP-tiedosto
5. Etsi Cost+ Payment Gateway moduuliluettelosta ja napsauta Install

Tapa B: Manuaalinen lataus (S)FTP:llä

1. Pura ladattu ZIP-tiedosto
2. SFTP-ohjelmalla lataa costpluspayment/-kansio kohteeseen /modules/costpluspayment/ PrestaShop-asennuksessasi
3. Siirry hallintapaneelissa kohtaan Modules and Services
4. Etsi Cost+ Payment Gateway ja napsauta Install

NoPayn-moduulin asetuksissa syötä API-avaimesi ja määritä seuraavat asetukset:

Liitä avain API Key -kenttään Cost+ Library -asetussivulla ja napsauta Save.

Liitä avain API Key -kenttään Cost+ Library -asetussivulla ja napsauta Save.

Asennuksen jälkeen napsauta Configure Cost+ Payment Gateway -moduulissa ja aseta seuraavat:

Tallennuksen jälkeen avaa Payment > Restrictions ja ota Cost+ Payment Gateway -moduuli käyttöön jokaiselle hyväksymällesi valuutalle.

Maksutavat määritetään suoraan moduulin asetuksissa (katso vaihe 2 yllä). Ota kukin tapa käyttöön tai poista käytöstä tarpeen mukaan.

API-avaimen tallentamisen jälkeen lataa kukin maksutapamoduuli erikseen kohdasta Upload a module.

Palaa kohtaan Improve > Module Manager, napsauta Upload a module uudelleen ja lataa kukin ZIP-tiedosto käyttöön otettaville maksutavoille (esim. Credit Card, MobilePay, Swish).

Maksumoduuleissa on joko Configure-vaihtoehto (jos lisäasetuksia tarvitaan) tai pelkkä käyttöön-/poistokytkin.

API-avaimen tallentamisen jälkeen lataa kukin maksutapamoduuli erikseen kohdasta Upload a module.

Palaa kohtaan Improve > Module Manager, napsauta Upload a module uudelleen ja lataa kukin ZIP-tiedosto käyttöön otettaville maksutavoille (esim. Credit Card, MobilePay, Swish).

Maksumoduuleissa on joko Configure-vaihtoehto (jos lisäasetuksia tarvitaan) tai pelkkä käyttöön-/poistokytkin.

Maksutavat otetaan käyttöön suoraan moduulin asetussivulla (katso vaihe 2 yllä). Ota käyttöön kukin tapa, jonka haluat olevan saatavilla kassalla.

Webhook

Webhook-URL määritetään automaattisesti tilauskohtaisesti:

https://your-shop.com/module/nopaynpayment/webhook

Manuaalinen veloitus

Kun käytössä luottokorttimaksuille:

• Maksu valtuutetaan mutta ei veloiteta kassalla
• Veloitus tapahtuu, kun tilaus lähetetään / merkitään valmiiksi
• Jos tilaus peruutetaan, valtuutus mitätöidään automaattisesti

Automaattinen palautus

Jos veloitetun maksutilauksen tila muutetaan peruutetuksi, moduuli tekee automaattisesti täyden palautuksen. Osittaiset palautukset voidaan käsitellä PrestaShop-hyvityslaskujen kautta.

Kassan painikkeiden tekstit

Parhaan käyttökokemuksen takaamiseksi ulkoisella uudelleenohjauksella toimivissa maksukuluissa harkitse kassan painikkeen tekstin muuttamista muotoon "Review order" aiemman "Confirm and pay" sijaan, koska varsinainen maksu tapahtuu Cost+:n isännöidyllä sivulla. Tämä on globaali PrestaShop-asetus, ei moduulikohtainen.

Webhook

Webhook määritetään automaattisesti moduulin toimesta. Manuaalista asetusta ei tarvita.

Webhook

Webhook määritetään automaattisesti moduulin toimesta. Manuaalista asetusta ei tarvita.

Webhook

Moduulin asetussivulla näkyy webhook-URL. Kopioi se Cost+-hallintapaneeliisi, jos Cost+-tilisi vaatii staattisen webhook-rekisteröinnin.

Webhook-päätepiste vastaanottaa Cost+-tapahtumat, kutsuu sitten Cost+:aa uudelleen pyynnöllä GET /orders/{id} ennen PrestaShop-tilauksen päivittämistä — tämä tekee paluu-URL:n ja webhookin käsittelystä idempotentin.

Vanhentumis-cron

Moduulin asetussivulla näkyy vanhentumis-cron-URL. Ajasta se suoritettavaksi joka minuutti:

* * * * * curl -fsS "https://your-shop.example/index.php?fc=module&module=costpluspayment&controller=cron&token=..." >/dev/null

Käytä tarkalleen sitä URL:ää, joka näkyy PrestaShop-hallintapaneelissa — token luodaan asennuksen aikana ja se on erilainen jokaisessa kaupassa. Cron-päätepiste peruuttaa vanhentuneet odottavat Cost+-tilaukset määritetyn Checkout Expiry -ajan jälkeen.

Manuaalinen veloitus ja palautukset

• Kun Manual Capture on käytössä, maksut valtuutetaan kassalla ja veloitetaan, kun tilaus lähetetään / merkitään valmiiksi
• Jos veloitettu tilaus peruutetaan, moduuli tekee automaattisesti täyden palautuksen
• Osittaiset palautukset käsitellään PrestaShop-hyvityslaskujen kautta