osCommerce
Integrirajte Cost+ s svojo osCommerce 4 trgovino z uradnim plačilnim modulom

Integrirajte Cost+ kot plačilno metodo v svojo osCommerce 4 trgovino. Uradni modul NoPayn Payments uporablja tok gostovane plačilne strani, tako da nobeni kartični podatki ne pridejo v stik z vašim strežnikom — v celoti skladen s PCI DSS.
Predpogoji
- Aktiven trgovski račun Cost+
- osCommerce 4.x
- PHP 8.1 ali novejši
- Razširitev cURL omogočena
- SSL certifikat (HTTPS obvezen)
- Skrbniški dostop do vaše osCommerce skrbniške plošče
Podprte plačilne metode
| Oznaka na blagajni | NoPayn identifikator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Vsako metodo je mogoče posamično omogočiti ali onemogočiti iz skrbniške plošče.
1. Namestite modul
Prenesite ali klonirajte modul z GitHub.
Kopirajte imenik lib/ v korensko mapo vaše osCommerce 4 namestitve:
cp -r lib/ /path/to/oscommerce/To postavi datoteke modula na:
lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.phpV vaši osCommerce skrbniški plošči:
- Pojdite na Moduli → Plačila → Na spletu
- Omogočite filtre Prikaži neaktivne in Prikaži nenameščene, če je potrebno
- Poiščite NoPayn Payments in kliknite Namesti
2. Konfigurirajte modul
Prijavite se v portal trgovca in pojdite na Spletna mesta, nato kliknite na spletno mesto, ki ga želite povezati. Kliknite na Integracija, kjer boste našli vaš API ključ.

Vnesite vaš API ključ in konfigurirajte naslednje nastavitve:
| Nastavitev | Opis | Privzeto |
|---|---|---|
| Enable NoPayn Payments | Glavno stikalo za omogočanje/onemogočanje | True |
| API Key | Vaš NoPayn API ključ | — |
| Enable Credit / Debit Card | Prikaži kreditno/debetno kartico na blagajni | True |
| Enable Apple Pay | Prikaži Apple Pay na blagajni | True |
| Enable Google Pay | Prikaži Google Pay na blagajni | True |
| Enable Vipps MobilePay | Prikaži Vipps MobilePay na blagajni | True |
| Manual Capture (Credit Card) | Samo avtorizacija — zajem ob dokončanju naročila | False |
| Debug Logging | Zapisuj API zahteve/odgovore v dnevnik | False |
| Completed Order Status | Status pri uspešnem plačilu | Processing |
| Pending Order Status | Status med čakanjem na plačilo | Pending |
| Cancelled Order Status | Status ob preklicu/neuspehu/poteku | Cancelled |
| Payment Zone | Omejitev na geografsko cono (neobvezno) | Vse cone |
| Sort Order | Vrstni red prikaza na strani blagajne | 0 |
Aktivirajte samo plačilne metode, za katere ste bili odobreni in ste prejeli potrditev.
3. Posodobite oznake blagajne (priporočeno)
Privzete oznake gumbov blagajne osCommerce predpostavljajo enostopenjski tok. Za boljšo izkušnjo s preusmeritvijo na zunanjo plačilno stran posodobite te prevode v Admin → Lokalizacija → Jeziki → Slovenščina → Definiraj:
| Ključ | Privzeto | Priporočeno |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Pojdi na plačilo |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Pregled naročila |
CONFIRM_ORDER | Confirm order | Potrdi in plačaj |
To izboljša izkušnjo stranke z jasnejšim tokom blagajne — stranke razumejo, da bodo preusmerjene na varno stran za dokončanje plačila.
4. Tok plačila
Ko je konfigurirano, tok plačila deluje na naslednji način:
- Stranka izbere plačilno metodo Cost+ na blagajni
- Stranka potrdi naročilo
- Modul ustvari čakajoče naročilo in pokliče Cost+ API
- Stranka je preusmerjena na gostovano plačilno stran Cost+ (HPP)
- Stranka dokonča plačilo na varni HPP
- Stranka je preusmerjena nazaj v trgovino
- Modul preveri status plačila prek Cost+ API
- Status naročila se ustrezno posodobi
Plačilne povezave potečejo po 5 minutah. Če stranka ne dokonča plačila v tem oknu, je naročilo samodejno označeno kot preklicano.
5. Webhook-i
Modul registrira URL webhook-a pri Cost+ za posodobitve statusa med strežnikoma. Ko se status plačila spremeni, Cost+ pošlje obvestilo in modul:
- Prejme webhook POST
- Preveri status plačila prek API-ja (nikoli ne zaupa koristnim podatkom webhook-a)
- Posodobi status naročila v osCommerce
Ročna konfiguracija webhook-a ni potrebna — modul samodejno obravnava registracijo.
Ročni zajem
Ko je omogočen za kartična plačila:
- Plačilo je avtorizirano, vendar ni zajeto ob blagajni
- Sredstva so zajeta, ko naročilo preide v status dokončano
- Če je naročilo preklicano, je avtorizacija samodejno razveljavljena
Uporabite ročni zajem, če želite strankam zaračunati šele, ko je njihovo naročilo odposlano. To je koristno za trgovce z daljšimi časi izpolnjevanja.
Beleženje za odpravljanje napak
Ko je beleženje za odpravljanje napak omogočeno, modul zapisuje v nopayn_debug.log v imeniku dnevnikov osCommerce. Vnosi v dnevnik vključujejo:
- Vse API zahteve in odgovore
- Webhook dogodke in rezultate obdelave
- Operacije zajema in razveljavitve
- Napake (vedno beležene, ne glede na nastavitev beleženja)
Vsi vnosi imajo predpono NoPayn_ za enostavno filtriranje.
Odstranitev
- Pojdite na Moduli → Plačila → Na spletu v skrbniški plošči
- Izberite NoPayn Payments
- Kliknite Odstrani
Odstranitev modula odstrani konfiguracijo in izbriše tabeli nopayn_transactions in nopayn_refunds iz podatkovne baze. Poskrbite, da izvozite vse potrebne podatke pred odstranitvijo.
Testirajte in zaženite
Izvedite nekaj testnih transakcij, da zagotovite nemoteno delovanje. Priporočamo testiranje tako uspešnih kot neuspešnih plačil za potrditev pravilne obravnave vseh scenarijev.
Podpora
Potrebujete pomoč? Obrnite se na našo ekipo za podporo na support@costplus.io.