Cost+Docs

PrestaShop

Integreerige Cost+ oma PrestaShop poega (9.x, 8.x, 1.7 ja 1.6)

PrestaShop

Integreerige Cost+ makseviisina oma PrestaShop poega. Cost+ moodul on saadaval PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 ja PrestaShop 1.6.1.x jaoks.

Eeldused

  • Aktiivne Cost+ kaupmehe konto
  • PrestaShop 9.1 või uuem
  • PHP 8.1 või uuem
  • SSL/HTTPS lubatud
  • Administraatori juurdepääs teie PrestaShop halduspaneelile
  • Aktiivne Cost+ kaupmehe konto
  • PrestaShop 8.x paigaldus
  • PHP 8.0 või uuem
  • Administraatori juurdepääs teie PrestaShop halduspaneelile
  • MySQL 5.4 või uuem
  • Aktiivne Cost+ kaupmehe konto
  • PrestaShop 1.7.x paigaldus
  • PHP 5.4 või uuem
  • Administraatori juurdepääs teie PrestaShop halduspaneelile
  • MySQL 5.4 või uuem
  • Aktiivne Cost+ kaupmehe konto
  • PrestaShop 1.6.1.x paigaldus
  • PHP 5.6 või uuem (cURL ja OpenSSL laienditega)
  • SSL/HTTPS lubatud poes
  • Administraatori juurdepääs teie PrestaShop halduspaneelile

1. Paigaldage moodul

Laadige moodul alla GitHubist.

Meetod A: Üleslaadimine halduspaneeli kaudu (soovitatav)

  1. Minge oma halduspaneelis jaotisse Modules → Module Manager
  2. Klõpsake Upload a module
  3. Lohistage ZIP-fail või valige see käsitsi
  4. Oodake, kuni paigaldamine lõpeb
  5. Otsige "NoPayn" ja klõpsake Configure

Meetod B: Käsitsi üleslaadimine

  1. Kopeerige kaust nopaynpayment/ oma PrestaShop kataloogis modules/
  2. Minge jaotisse Modules → Module Manager
  3. Otsige "NoPayn" ja klõpsake Install
  4. Klõpsake Configure, et avada seaded

Laadige moodul alla GitHubist.

Meetod A: Üleslaadimine halduspaneeli kaudu (soovitatav)

  1. Minge oma halduspaneelis jaotisse Improve > Module Manager
  2. Klõpsake Upload a module
  3. Lohistage ZIP-fail või valige see käsitsi
  4. Oodake, kuni paigaldamine lõpeb
  5. Kerige alla jaotiseni "Other" ja klõpsake Cost+ all Configure

PrestaShop 8 Module Manager

Mooduli üleslaadimise dialoog

Meetod B: Käsitsi üleslaadimine (S)FTP kaudu

  1. Pakkige allalaaditud ZIP-fail lahti
  2. Kasutades SFTP klienti (nt FileZilla, WinSCP), laadige kõik kaustad üles kataloogi /modules/ oma PrestaShop paigalduses
  3. Minge jaotisse Improve > Modules > Module Catalog
  4. Otsige "Cost+" -- vaadake vajadusel vahekaarti Uninstalled Modules
  5. Klõpsake Install

Laadige moodul alla GitHubist.

Meetod A: Üleslaadimine halduspaneeli kaudu (soovitatav)

  1. Minge oma halduspaneelis jaotisse Improve > Module Manager
  2. Klõpsake Upload a module
  3. Lohistage ZIP-fail või valige see käsitsi
  4. Oodake, kuni paigaldamine lõpeb
  5. Kerige alla jaotiseni "Other" ja klõpsake Cost+ all Configure

PrestaShop 1.7 Module Manager

Mooduli üleslaadimise dialoog

Meetod B: Käsitsi üleslaadimine (S)FTP kaudu

  1. Pakkige allalaaditud ZIP-fail lahti
  2. Kasutades SFTP klienti (nt FileZilla, WinSCP), laadige kõik kaustad üles kataloogi /modules/ oma PrestaShop paigalduses
  3. Minge jaotisse Modules > Module Manager
  4. Otsige "Cost+" -- vaadake vajadusel vahekaarti Uninstalled Modules
  5. Klõpsake Install

Laadige moodul alla GitHubist.

Meetod A: Üleslaadimine halduspaneeli kaudu (soovitatav)

  1. Laadige costpluspayment.zip alla GitHub Releases lehelt
  2. Minge PrestaShop halduspaneelis jaotisse Modules and Services
  3. Klõpsake Add a new module
  4. Laadige ZIP-fail üles
  5. Leidke Cost+ Payment Gateway moodulite loendist ja klõpsake Install

Meetod B: Käsitsi üleslaadimine (S)FTP kaudu

  1. Pakkige allalaaditud ZIP-fail lahti
  2. Kasutades SFTP klienti, laadige kaust costpluspayment/ üles asukohta /modules/costpluspayment/ oma PrestaShop paigalduses
  3. Minge halduspaneelis jaotisse Modules and Services
  4. Leidke Cost+ Payment Gateway ja klõpsake Install

2. Sisestage API mandaadid

Logige sisse kaupmehe portaali ja navigeerige jaotisse Veebilehed, seejärel klõpsake veebilehel, mida soovite ühendada. Klõpsake Integratsioon, kus leiate oma API võtme.

Cost+ kaupmehe portaal näitab API võtit

NoPayn mooduli seadistuses sisestage oma API võti ja seadistage järgmised sätted:

SeadistusKirjeldus
API KeyTeie NoPayn API võti
Credit / Debit CardKrediitkaardimaksete lubamine/keelamine
Apple PayApple Pay lubamine/keelamine
Google PayGoogle Pay lubamine/keelamine
Vipps MobilePayVipps MobilePay lubamine/keelamine
Manual CaptureAutoriseerige krediitkaardimaksed ainult — hõivake saatmisel
Debug LoggingLuba üksikasjalik logimine faili var/logs/nopayn_debug.log

Kleepige võti Cost+ Library seadistuse lehel väljale API Key ja klõpsake Save.

Cost+ seadistusleht PrestaShop 8-s

Kleepige võti Cost+ Library seadistuse lehel väljale API Key ja klõpsake Save.

Cost+ seadistusleht PrestaShop 1.7-s

Pärast paigaldamist klõpsake Cost+ Payment Gateway moodulil Configure ja seadistage järgmist:

SeadistusKirjeldus
API KeyTeie Cost+ API võti kaupmehe portaalist
Credit / Debit CardKrediitkaardimaksete lubamine/keelamine
Apple PayApple Pay lubamine/keelamine
Google PayGoogle Pay lubamine/keelamine
Vipps MobilePayVipps MobilePay lubamine/keelamine
Manual CaptureAutoriseerige krediitkaardimaksed — hõivake saatmisel
Checkout ExpiryOotava tellimuse aegumine minutites (vaikimisi 5)
Debug LoggingLuba üksikasjalik logimine faili log/costplus_debug.log

Pärast salvestamist avage Payment > Restrictions ja lubage Cost+ Payment Gateway moodul iga aktsepteeritava valuuta jaoks.

PrestaShop 8.x, 1.7 ja 1.6 hostingkeskkondade jaoks lubage seadistamise ajal valik cURL CA bundle, et vältida SSL-sertifikaadi probleeme.

3. Lubage makseviisid

Makseviisid seadistatakse otse mooduli seadetes (vt 2. samm ülal). Lülitage iga meetod vastavalt vajadusele sisse või välja.

Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.

Pärast API võtme salvestamist laadige iga makseviisi moodul eraldi üles valikuga Upload a module.

Minge tagasi jaotisse Improve > Module Manager, klõpsake uuesti Upload a module ja laadige üles iga ZIP-fail makseviisidele, mida soovite lubada (nt krediitkaart, MobilePay, Swish).

Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.

Maksemoodulitel on kas Configure valik (kui on vaja täiendavat seadistamist) või lihtsalt lubamise/keelamise lüliti.

Pärast API võtme salvestamist laadige iga makseviisi moodul eraldi üles valikuga Upload a module.

Minge tagasi jaotisse Improve > Module Manager, klõpsake uuesti Upload a module ja laadige üles iga ZIP-fail makseviisidele, mida soovite lubada (nt krediitkaart, MobilePay, Swish).

Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.

Maksemoodulitel on kas Configure valik (kui on vaja täiendavat seadistamist) või lihtsalt lubamise/keelamise lüliti.

Makseviise lülitatakse otse mooduli seadistuse lehel (vt 2. samm ülal). Lubage iga meetod, mida soovite kassas saadaval olla.

Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.

Maksevoog

  1. Klient valib kassas Cost+ makseviisi
  2. Klient suunatakse Cost+ hostitud makselehele (HPP)
  3. Pärast makse lõpetamist suunatakse klient tagasi poodi
  4. Veebihaak kinnitab makse oleku server-server suhtluses

Veebihaak

Veebihaagi URL seadistatakse automaatselt iga tellimuse kohta:

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

Käsitsi veebihaagi seadistamist pole vaja — moodul käsitleb registreerimist automaatselt.

Käsitsi hõivamine

Kui lubatud krediitkaardimaksete jaoks:

  • Makse autoriseeritakse, kuid ei hõivata kassas
  • Hõivamine toimub, kui tellimus saadetakse / märgitakse lõpetatuks
  • Kui tellimus tühistatakse, tühistatakse autoriseerimine automaatselt

Automaatne tagasimakse

Kui hõivatud makse tellimus tühistatakse, väljastab moodul automaatselt täieliku tagasimakse. Osalisi tagasimakseid saab töödelda PrestaShop krediitmärkuste kaudu.

Kassanupu sildid

Parima kasutajakogemuse jaoks väljasaidile suunamise voogudega kaaluge kassanupu sildi muutmist "Review order" asemel "Confirm and pay", kuna tegelik makse toimub Cost+ hostitud lehel. See on globaalne PrestaShop seadistus, mitte moodulispetsiifiline.

Veebihaak

Veebihaak seadistatakse mooduli poolt automaatselt. Käsitsi seadistamist pole vaja.

Veebihaak

Veebihaak seadistatakse mooduli poolt automaatselt. Käsitsi seadistamist pole vaja.

Veebihaak

Mooduli seadistuse leht kuvab veebihaagi URL-i. Kopeerige see oma Cost+ töölauale, kui teie Cost+ konto nõuab staatilist veebihaagi registreerimist.

Veebihaagi lõpp-punkt võtab vastu Cost+ sündmusi, seejärel kutsub Cost+ uuesti välja GET /orders/{id} enne PrestaShopi tellimuse uuendamist — see muudab tagasituleku URL-i ja veebihaagi käsitlemise idempotentseks.

Aegumise cron

Mooduli seadistuse leht kuvab aegumise cron-i URL-i. Planeerige see jooksma iga minut:

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

Kasutage täpset URL-i, mida kuvatakse teie PrestaShopi halduspaneelis — token genereeritakse paigaldamise ajal ja on iga poe jaoks erinev. Cron-i lõpp-punkt tühistab aegunud ootavad Cost+ tellimused pärast konfigureeritud Checkout Expiry.

Käsitsi hõivamine ja tagasimaksed

  • Kui Manual Capture on lubatud, makseid autoriseeritakse kassas ja hõivatakse, kui tellimus saadetakse / märgitakse lõpetatuks
  • Kui hõivatud tellimus tühistatakse, väljastab moodul automaatselt täieliku tagasimakse
  • Osalisi tagasimakseid töödeldakse PrestaShop krediitmärkuste kaudu

4. Lõppsammud ja testimine

  1. Kontrollige uuesti kõiki lubatud makseviise
  2. Tehke mõned testtehingud -- nii edukad kui ebaõnnestunud -- et veenduda kõige sujuvas toimimises
  3. Seadistage täpsem käitumine, nagu käsitsi vs automaat-hõivamine vastavalt teie täitmisprotsessile

Tugi

Vajate abi? Võtke ühendust meie tugimeeskonnaga aadressil support@costplus.io.

On this page