DocsosCommerce
Samþættu Cost+ með svojo osCommerce 4 verslun með opinberu greiðslunim modulom
Samþættu Cost+ sem greiðslumáta í osCommerce 4 verslun. Opinber eining NoPayn Payments uporablja tok gostovane greiðslune strani, taþegar da nobeni kartični podatki ne pridejo í stik með þínum strežnikom — í celoti skladen með PCI DSS.
Forsendur
- Virkur söluaðilareikningur Cost+
- osCommerce 4.x
- PHP 8.1 eða novejši
- Viðbót cURL omogočena
- SSL certifikat (HTTPS obvezen)
- Stjórnandaaðgangur do þitt osCommerce stjórnborðsins
Studdir greiðslumátar
| Oznaka á afgreiðslu | NoPayn identifikator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Vsaþegar metodo er mogoef posamično omogočiti eða onemogočiti iz stjórnborðsins.
1. Settu upp modul
Sæktu eða klonirajte eining með GitHub.
Afritaðu imenik lib/ í korensþegar mapo þitt osCommerce 4 namestitve:
cp -r lib/ /path/to/oscommerce/To postavi datoteke einingar 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 þínu osCommerce stjórnborði:
- Farðu á Einingi → Greiðslur → Na spletu
- Virkjaðu filtre Prikaži neaktivne og Prikaži nenameščene, ef er potrebno
- Poiščite NoPayn Payments og smelltu Namesti
2. Stilltu modul
Skráðu þig inn í gátt söluaðila og farðu í Vefsíður, smelltu síðan á vefsíðu, ki ga želite povezati. Smelltu á Samþætting, þar sem þú finnur þinn API lykill.
Sláðu inn þinn API lykill og stilltu naslednje nastavitve:
| Stilling | Opis | Privzeto |
|---|---|---|
| Enable NoPayn Payments | Glavno stikalo til omogočanje/onemogočanje | True |
| API Key | Vaš NoPayn API lykill | — |
| Enable Credit / Debit Card | Prikaži kreditno/debetno kartico á afgreiðslu | True |
| Enable Apple Pay | Prikaži Apple Pay á afgreiðslu | True |
| Enable Google Pay | Prikaži Google Pay á afgreiðslu | True |
| Enable Vipps MobilePay | Prikaži Vipps MobilePay á afgreiðslu | True |
| Manual Capture (Credit Card) | Aðeins avtorizacija — zajem ob dokončanju pantanir | False |
| Debug Logging | Zapisuj API zahteve/odgovore í dnevnik | False |
| Completed Order Status | Status pri uspešnem greiðsluu | Processing |
| Pending Order Status | Status med čakanjem á greiðsla | Pending |
| Cancelled Order Status | Status ob preklicu/neuspehu/poteku | Cancelled |
| Payment Zone | Omejitev á geografsþegar cono (neobvezno) | Öll cone |
| Sort Order | Vrstni red prikaza á strani blagajne | 0 |
Virkjaðu aðeins þá greiðslumáta sem þú hefur fengið samþykki og staðfestingu fyrir.
3. Posodobite oznake blagajne (priporočeno)
Privzete oznake gumbov blagajne osCommerce predpostavljajo enostopenjski tok. Za boljšo izkušnjo með preusmeritvijo á zunanjo greiðsluno stran posodobite te prevode í Admin → Lokalizacija → Jeziki → Slovenščina → Definiraj:
| Ključ | Privzeto | Priporočeno |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Pojdi á greiðsla |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Yfirlit pantanir |
CONFIRM_ORDER | Confirm order | Potrdi og plačaj |
To izboljša izkušnjo viðskiptavinar með jasnejšim tokom blagajne — viðskiptavinar razumejo, da bodo preusmerjene á varno stran til dokončanje greiðslur.
4. Greiðsluflæðir
Þegar er konfigurirano, tok greiðslur deluje á naslednji način:
- Viðskiptavinur izbere greiðslumáta Cost+ á afgreiðslu
- Viðskiptavinur potrdi pöntun
- Eining ustvari čakajoef pöntun og poklief Cost+ API
- Viðskiptavinur er preusmerjena á gostovano greiðsluno stran Cost+ (HPP)
- Viðskiptavinur dokonča greiðsla á varni HPP
- Viðskiptavinur er preusmerjena nazaj í verslun
- Eining preveri status greiðslur gegnum Cost+ API
- Status pantanir sig ustrezno posodobi
Greiðslutenglar potečejo eftir 5 minutah. Ef viðskiptavinur ne dokonča greiðslur í tem oknu, er pöntun samodejno označeno kot preklicano.
5. Webhook-i
Eining registrira URL webhook-a pri Cost+ til posodobitve statusa med strežnikoma. Þegar sig status greiðslur spremeni, Cost+ pošlje obvestilo og modul:
- Prejme webhook POST
- Preveri status greiðslur gegnum API-ja (nikoli ne zaupa koristnim podatkom webhook-a)
- Posodobi status pantanir í osCommerce
Handvirk webhook-stilling er ekki nauðsynleg — einingin meðhöndlar skráningu sjálfkrafa.
Ročni zajem
Þegar er omogočen til kartična greiðslur:
- Greiðsla er avtorizirano, en er ekki zajeto ob afgreiðslu
- Sredstva eru zajeta, þegar pöntun preide í status dokončano
- Ef er pöntun preklicano, er avtorizacija samodejno razveljavljena
Uporabite ročni zajem, ef želite viðskiptavinurm zaračunati šele, þegar er njihovo pöntun odposlano. To er koristno til trgovce með daljšimi časi izpolnjevanja.
Beleženje til odpravljanje napak
Þegar er beleženje til odpravljanje napak omogočeno, eining zapisuje í nopayn_debug.log í imeniku dnevnikov osCommerce. Vnosi í dnevnik vključujejo:
- Öll API zahteve og odgovore
- Webhook dogodke og rezultate obdelave
- Operacije zajema og razveljavitve
- Napake (vedno beležene, ne glede á stillingar beleženja)
Vsi vnosi imajo predpono NoPayn_ til enostavno filtriranje.
Odstranitev
- Farðu á Einingi → Greiðslur → Na spletu í stjórnborði
- Izberite NoPayn Payments
- Smelltu Odstrani
Odstranitev einingar odstrani konfiguracijo og izbriše tabeli nopayn_transactions og nopayn_refunds iz podatkovne baze. Gakktu úr skugga um, da izvozite öll potrebne podatke pred odstranitvijo.
Prófaðu og settu í gang
Framkvæmdu nokkrar prófunarfærslur, til að tryggja hnökralausan gang. Við mælum með prófun bæði vel heppnaðra og misheppnaðra greiðslna til að staðfesta rétta meðhöndlun allra aðstæðna.
Aðstoð
Þarftu aðstoð? Hafðu samband við þjónustudeild okkar á support@costplus.io.