Cost+Docs

PrestaShop

Integruokite Cost+ su savo PrestaShop parduotuve (9.x, 8.x, 1.7 ir 1.6)

PrestaShop

Integruokite Cost+ kaip mokėjimo būdą savo PrestaShop parduotuvėje. Cost+ modulis prieinamas PrestaShop 9.x, PrestaShop 8.x, PrestaShop 1.7 ir PrestaShop 1.6.1.x.

Būtinosios sąlygos

  • Aktyvi Cost+ prekybininko paskyra
  • PrestaShop 9.1 arba naujesnė
  • PHP 8.1 arba naujesnė
  • SSL/HTTPS įjungtas
  • Administratoriaus prieiga prie jūsų PrestaShop administravimo skydelio
  • Aktyvi Cost+ prekybininko paskyra
  • PrestaShop 8.x diegimas
  • PHP 8.0 arba naujesnė
  • Administratoriaus prieiga prie jūsų PrestaShop administravimo skydelio
  • MySQL 5.4 arba naujesnė
  • Aktyvi Cost+ prekybininko paskyra
  • PrestaShop 1.7.x diegimas
  • PHP 5.4 arba naujesnė
  • Administratoriaus prieiga prie jūsų PrestaShop administravimo skydelio
  • MySQL 5.4 arba naujesnė
  • Aktyvi Cost+ prekybininko paskyra
  • PrestaShop 1.6.1.x diegimas
  • PHP 5.6 arba naujesnė (su cURL ir OpenSSL plėtiniais)
  • SSL/HTTPS įjungtas parduotuvėje
  • Administratoriaus prieiga prie jūsų PrestaShop administravimo skydelio

1. Įdiekite modulį

Atsisiųskite modulį iš GitHub.

A būdas: Įkėlimas per administravimo skydelį (rekomenduojama)

  1. Eikite į Modules -> Module Manager administravimo skydelyje
  2. Paspauskite Upload a module
  3. Vilkite ir numeskite ZIP failą arba pasirinkite jį rankiniu būdu
  4. Palaukite, kol diegimas baigsis
  5. Ieškokite "NoPayn" ir paspauskite Configure

B būdas: Rankinis įkėlimas

  1. Nukopijuokite nopaynpayment/ aplanką į savo PrestaShop modules/ katalogą
  2. Eikite į Modules -> Module Manager
  3. Ieškokite "NoPayn" ir paspauskite Install
  4. Paspauskite Configure, kad atidarytumėte nustatymus

Atsisiųskite modulį iš GitHub.

A būdas: Įkėlimas per administravimo skydelį (rekomenduojama)

  1. Eikite į Improve > Module Manager administravimo skydelyje
  2. Paspauskite Upload a module
  3. Vilkite ir numeskite ZIP failą arba pasirinkite jį rankiniu būdu
  4. Palaukite, kol diegimas baigsis
  5. Slinkite žemyn iki "Other" skilties ir paspauskite Configure prie Cost+

PrestaShop 8 Module Manager

Upload a module dialogas

B būdas: Rankinis įkėlimas per (S)FTP

  1. Išskleiskite atsisiųstą ZIP failą
  2. Naudodami SFTP klientą (pvz., FileZilla, WinSCP), įkelkite visus aplankus į /modules/ katalogą savo PrestaShop diegime
  3. Eikite į Improve > Modules > Module Catalog
  4. Ieškokite "Cost+" -- patikrinkite Uninstalled Modules skirtuką, jei reikia
  5. Paspauskite Install

Atsisiųskite modulį iš GitHub.

A būdas: Įkėlimas per administravimo skydelį (rekomenduojama)

  1. Eikite į Improve > Module Manager administravimo skydelyje
  2. Paspauskite Upload a module
  3. Vilkite ir numeskite ZIP failą arba pasirinkite jį rankiniu būdu
  4. Palaukite, kol diegimas baigsis
  5. Slinkite žemyn iki "Other" skilties ir paspauskite Configure prie Cost+

PrestaShop 1.7 Module Manager

Upload a module dialogas

B būdas: Rankinis įkėlimas per (S)FTP

  1. Išskleiskite atsisiųstą ZIP failą
  2. Naudodami SFTP klientą (pvz., FileZilla, WinSCP), įkelkite visus aplankus į /modules/ katalogą savo PrestaShop diegime
  3. Eikite į Modules > Module Manager
  4. Ieškokite "Cost+" -- patikrinkite Uninstalled Modules skirtuką, jei reikia
  5. Paspauskite Install

Atsisiųskite modulį iš GitHub.

A būdas: Įkėlimas per administravimo skydelį (rekomenduojama)

  1. Atsisiųskite costpluspayment.zip iš GitHub Releases puslapio
  2. Eikite į Modules and Services PrestaShop administravimo skydelyje
  3. Paspauskite Add a new module
  4. Įkelkite ZIP failą
  5. Suraskite Cost+ Payment Gateway modulių sąraše ir paspauskite Install

B būdas: Rankinis įkėlimas per (S)FTP

  1. Išskleiskite atsisiųstą ZIP failą
  2. Naudodami SFTP klientą, įkelkite aplanką costpluspayment/ į /modules/costpluspayment/ savo PrestaShop diegime
  3. Eikite į Modules and Services administravimo skydelyje
  4. Suraskite Cost+ Payment Gateway ir paspauskite Install

2. Įveskite API kredencialus

Prisijunkite prie prekybininko portalo ir eikite į Websites, tada paspauskite svetainę, kurią norite prijungti. Paspauskite Integration, kur rasite savo API raktą.

Cost+ prekybininko portalas, rodantis API raktą

NoPayn modulio konfigūracijoje įveskite savo API raktą ir sukonfigūruokite šiuos nustatymus:

NustatymasAprašymas
API KeyJūsų NoPayn API raktas
Credit / Debit CardĮjungti/išjungti kreditinių kortelių mokėjimus
Apple PayĮjungti/išjungti Apple Pay
Google PayĮjungti/išjungti Google Pay
Vipps MobilePayĮjungti/išjungti Vipps MobilePay
Manual CaptureAutorizuoti kreditinių kortelių mokėjimus — surinkti siunčiant
Debug LoggingĮjungti detalų registravimą į var/logs/nopayn_debug.log

Įklijuokite raktą į API Key lauką Cost+ Library konfigūracijos puslapyje ir paspauskite Save.

Cost+ konfigūracijos puslapis PrestaShop 8

Įklijuokite raktą į API Key lauką Cost+ Library konfigūracijos puslapyje ir paspauskite Save.

Cost+ konfigūracijos puslapis PrestaShop 1.7

Po diegimo paspauskite Configure prie Cost+ Payment Gateway modulio ir nustatykite šiuos parametrus:

NustatymasAprašymas
API KeyJūsų Cost+ API raktas iš prekybininko portalo
Credit / Debit CardĮjungti/išjungti kreditinių kortelių mokėjimus
Apple PayĮjungti/išjungti Apple Pay
Google PayĮjungti/išjungti Google Pay
Vipps MobilePayĮjungti/išjungti Vipps MobilePay
Manual CaptureAutorizuoti kreditinių kortelių mokėjimus — surinkti siunčiant
Checkout ExpiryLaukiamo užsakymo galiojimo pabaigos laikas minutėmis (numatytasis 5)
Debug LoggingĮjungti detalų registravimą į log/costplus_debug.log

Po išsaugojimo atidarykite Payment > Restrictions ir įjunkite Cost+ Payment Gateway modulį kiekvienai priimamai valiutai.

PrestaShop 8.x, 1.7 ir 1.6 prieglobos aplinkose įjunkite cURL CA bundle parinktį konfigūracijos metu, kad išvengtumėte SSL sertifikato problemų.

3. Įjunkite mokėjimo būdus

Mokėjimo būdai konfigūruojami tiesiogiai modulio nustatymuose (žr. 2 žingsnį aukščiau). Perjunkite kiekvieną būdą pagal poreikį.

Aktyvuokite tik tuos mokėjimo būdus, kuriems esate patvirtinti ir gavote patvirtinimą.

Išsaugoję API raktą, įkelkite kiekvieną mokėjimo būdo modulį atskirai per Upload a module.

Grįžkite į Improve > Module Manager, dar kartą paspauskite Upload a module ir įkelkite kiekvieną ZIP failą mokėjimo būdams, kuriuos norite įjungti (pvz., Credit Card, MobilePay, Swish).

Aktyvuokite tik tuos mokėjimo būdus, kuriems esate patvirtinti ir gavote patvirtinimą.

Mokėjimo moduliai turės arba Configure parinktį (jei reikia papildomo nustatymo), arba tik įjungimo/išjungimo jungiklį.

Išsaugoję API raktą, įkelkite kiekvieną mokėjimo būdo modulį atskirai per Upload a module.

Grįžkite į Improve > Module Manager, dar kartą paspauskite Upload a module ir įkelkite kiekvieną ZIP failą mokėjimo būdams, kuriuos norite įjungti (pvz., Credit Card, MobilePay, Swish).

Aktyvuokite tik tuos mokėjimo būdus, kuriems esate patvirtinti ir gavote patvirtinimą.

Mokėjimo moduliai turės arba Configure parinktį (jei reikia papildomo nustatymo), arba tik įjungimo/išjungimo jungiklį.

Mokėjimo būdai perjungiami tiesiogiai modulio konfigūracijos puslapyje (žr. 2 žingsnį aukščiau). Įjunkite kiekvieną būdą, kurį norite turėti prieinamą atsiskaitymo metu.

Aktyvuokite tik tuos mokėjimo būdus, kuriems esate patvirtinti ir gavote patvirtinimą.

Mokėjimo procesas

  1. Klientas pasirenka Cost+ mokėjimo būdą atsiskaityme
  2. Klientas nukreipiamas į Cost+ mokėjimo puslapį (HPP)
  3. Užbaigus mokėjimą, klientas nukreipiamas atgal į parduotuvę
  4. Webhook patvirtina mokėjimo būseną serveris-serveriui

Webhook

Webhook URL automatiškai konfigūruojamas kiekvienam užsakymui:

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

Rankinis webhook konfigūravimas nereikalingas — modulis tvarko registraciją automatiškai.

Rankinis surinkimas

Kai įjungtas kreditinių kortelių mokėjimams:

  • Mokėjimas autorizuojamas, bet nesurenkamas atsiskaityme
  • Surinkimas įvyksta, kai užsakymas išsiunčiamas / pažymimas kaip užbaigtas
  • Jei užsakymas atšaukiamas, autorizacija automatiškai anuliuojama

Automatinis grąžinimas

Jei surinkto mokėjimo užsakymas atšaukiamas, modulis automatiškai atlieka pilną grąžinimą. Daliniai grąžinimai gali būti apdorojami per PrestaShop kreditinius kvitus.

Atsiskaitymo mygtukų etiketės

Geriausiai naudotojo patirčiai su nukreipimo srautais apsvarstykite atsiskaitymo mygtuko etiketės pakeitimą į "Review order" vietoj „Confirm and pay", nes faktinis mokėjimas vyksta Cost+ mokėjimo puslapyje. Tai yra globalus PrestaShop nustatymas, o ne specifinis moduliui.

Webhook

Webhook automatiškai konfigūruojamas modulio. Rankinis nustatymas nereikalingas.

Webhook

Webhook automatiškai konfigūruojamas modulio. Rankinis nustatymas nereikalingas.

Webhook

Modulio konfigūracijos puslapis rodo webhook URL. Nukopijuokite jį į savo Cost+ informacijos suvestinę, jei jūsų Cost+ paskyrai reikalinga statinė webhook registracija.

Webhook galinis taškas gauna Cost+ įvykius, tada vėl iškviečia Cost+ naudojant GET /orders/{id} prieš atnaujindamas PrestaShop užsakymą — tai padaro grąžinimo URL ir webhook apdorojimą idempotentišką.

Galiojimo cron

Modulio konfigūracijos puslapis rodo galiojimo cron URL. Suplanuokite jį vykdyti kiekvieną minutę:

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

Naudokite tikslų URL, rodomą jūsų PrestaShop administravimo skydelyje — žetonas generuojamas diegimo metu ir skiriasi kiekvienai parduotuvei. Cron galinis taškas atšaukia pasenusius laukiančius Cost+ užsakymus po sukonfigūruoto Checkout Expiry.

Rankinis surinkimas ir grąžinimai

  • Įjungus Manual Capture, mokėjimai atsiskaitymo metu autorizuojami ir surenkami, kai užsakymas išsiunčiamas / pažymimas kaip užbaigtas
  • Jei surinktas užsakymas atšaukiamas, modulis automatiškai atlieka pilną grąžinimą
  • Daliniai grąžinimai apdorojami per PrestaShop kreditinius kvitus

4. Galutiniai žingsniai ir testavimas

  1. Dar kartą patikrinkite visus įjungtus mokėjimo būdus
  2. Atlikite kelis testinius užsakymus -- tiek sėkmingus, tiek nesėkmingus -- kad įsitikintumėte, jog viskas veikia sklandžiai
  3. Sukonfigūruokite pažangų elgesį, pvz., rankinį vs. automatinį surinkimą, priklausomai nuo jūsų vykdymo proceso

Palaikymas

Reikia pagalbos? Kreipkitės į mūsų palaikymo komandą adresu support@costplus.io.

On this page