Cost+Docs

osCommerce

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

osCommerce

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 blagajniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-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.php

V vaši osCommerce skrbniški plošči:

  1. Pojdite na Moduli → Plačila → Na spletu
  2. Omogočite filtre Prikaži neaktivne in Prikaži nenameščene, če je potrebno
  3. 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č.

Portal trgovca Cost+ s prikazom API ključa

Vnesite vaš API ključ in konfigurirajte naslednje nastavitve:

NastavitevOpisPrivzeto
Enable NoPayn PaymentsGlavno stikalo za omogočanje/onemogočanjeTrue
API KeyVaš NoPayn API ključ—
Enable Credit / Debit CardPrikaži kreditno/debetno kartico na blagajniTrue
Enable Apple PayPrikaži Apple Pay na blagajniTrue
Enable Google PayPrikaži Google Pay na blagajniTrue
Enable Vipps MobilePayPrikaži Vipps MobilePay na blagajniTrue
Manual Capture (Credit Card)Samo avtorizacija — zajem ob dokončanju naročilaFalse
Debug LoggingZapisuj API zahteve/odgovore v dnevnikFalse
Completed Order StatusStatus pri uspešnem plačiluProcessing
Pending Order StatusStatus med čakanjem na plačiloPending
Cancelled Order StatusStatus ob preklicu/neuspehu/potekuCancelled
Payment ZoneOmejitev na geografsko cono (neobvezno)Vse cone
Sort OrderVrstni red prikaza na strani blagajne0

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čPrivzetoPriporočeno
TEXT_PAY_WITH_CARDPay with cardPojdi na plačilo
TEXT_CONFIRM_AND_PAYConfirm and payPregled naročila
CONFIRM_ORDERConfirm orderPotrdi 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:

  1. Stranka izbere plačilno metodo Cost+ na blagajni
  2. Stranka potrdi naročilo
  3. Modul ustvari čakajoče naročilo in pokliče Cost+ API
  4. Stranka je preusmerjena na gostovano plačilno stran Cost+ (HPP)
  5. Stranka dokonča plačilo na varni HPP
  6. Stranka je preusmerjena nazaj v trgovino
  7. Modul preveri status plačila prek Cost+ API
  8. 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:

  1. Prejme webhook POST
  2. Preveri status plačila prek API-ja (nikoli ne zaupa koristnim podatkom webhook-a)
  3. 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

  1. Pojdite na Moduli → Plačila → Na spletu v skrbniški plošči
  2. Izberite NoPayn Payments
  3. 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.

On this page