DocsosCommerce
Integreerige Cost+ oma osCommerce 4 poega ametliku maksemooduli abil
Integreerige Cost+ makseviisina oma osCommerce 4 poega. Ametlik NoPayn Payments moodul kasutab hostitud makselehe voogu, nii et kaardiandmed ei puutu teie serverit — täielikult PCI DSS-iga ühilduv.
Eeldused
- Aktiivne Cost+ kaupmehe konto
- osCommerce 4.x
- PHP 8.1 või uuem
- cURL laiendus lubatud
- SSL-sertifikaat (HTTPS nõutud)
- Administraatori juurdepääs teie osCommerce halduspaneelile
Toetatud makseviisid
| Kassa silt | NoPayn identifikaator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Iga meetodit saab halduspaneelist eraldi lubada või keelata.
1. Paigaldage moodul
Laadige alla või kloonige moodul GitHubist.
Kopeerige kataloog lib/ oma osCommerce 4 juurkataloogi:
cp -r lib/ /path/to/oscommerce/See paigutab mooduli failid asukohta:
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.phpOma osCommerce halduspaneelis:
- Navigeerige jaotisse Modules → Payment → Online
- Lubage vajadusel filtrid Show inactive ja Show not installed
- Leidke NoPayn Payments ja klõpsake Install
2. Seadistage moodul
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.
Sisestage oma API võti ja seadistage järgmised sätted:
| Seadistus | Kirjeldus | Vaikeväärtus |
|---|---|---|
| Enable NoPayn Payments | Üldine lubamise/keelamise lüliti | True |
| API Key | Teie NoPayn API võti | — |
| Enable Credit / Debit Card | Kuva krediit-/deebetkaart kassas | True |
| Enable Apple Pay | Kuva Apple Pay kassas | True |
| Enable Google Pay | Kuva Google Pay kassas | True |
| Enable Vipps MobilePay | Kuva Vipps MobilePay kassas | True |
| Manual Capture (Credit Card) | Ainult autoriseerimine — hõivamine tellimuse lõpetamisel | False |
| Debug Logging | Kirjuta API päringud/vastused logisse | False |
| Completed Order Status | Olek, mis määratakse makse õnnestumisel | Processing |
| Pending Order Status | Olek, mis määratakse makse ootamise ajal | Pending |
| Cancelled Order Status | Olek, mis määratakse tühistamise/ebaõnnestumise/aegumise korral | Cancelled |
| Payment Zone | Piira geograafilisele tsoonile (valikuline) | Kõik tsoonid |
| Sort Order | Kuvamisjärjekord kassal | 0 |
Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.
3. Uuendage kassa silte (soovitatav)
osCommerce vaikimisi kassanupu sildid eeldavad ühe-sammulist voogu. Parema kogemuse saamiseks väljasaidile suunamise maksevoo jaoks uuendage neid tõlkeid jaotises Admin → Localisation → Languages → English → Define:
| Võti | Vaikeväärtus | Soovitatav |
|---|---|---|
TEXT_PAY_WITH_CARD | Pay with card | Go to payment |
TEXT_CONFIRM_AND_PAY | Confirm and pay | Review order |
CONFIRM_ORDER | Confirm order | Confirm and pay |
See parandab kliendikogemust, muutes kassavoo selgemaks — kliendid mõistavad, et nad suunatakse makse lõpetamiseks turvalise lehe juurde.
4. Maksevoog
Pärast seadistamist töötab maksevoog järgmiselt:
- Klient valib kassas Cost+ makseviisi
- Klient kinnitab tellimuse
- Moodul loob ootel tellimuse ja kutsub Cost+ API-t
- Klient suunatakse Cost+ hostitud makselehele (HPP)
- Klient teostab makse turvalisel HPP-l
- Klient suunatakse tagasi poodi
- Moodul kontrollib makse olekut Cost+ API kaudu
- Tellimuse olek uuendatakse vastavalt
Makselingid aeguvad 5 minuti pärast. Kui klient ei vii makset selle aja jooksul lõpule, märgitakse tellimus automaatselt tühistatuks.
5. Veebihaagid
Moodul registreerib Cost+-is veebihaagi URL-i server-server olekuuuenduste jaoks. Kui makse olek muutub, saadab Cost+ teavituse ja moodul:
- Võtab vastu veebihaagi POST-i
- Kontrollib makse olekut API kaudu (ei usalda kunagi ainult veebihaagi andmeid)
- Uuendab tellimuse oleku osCommerce'is
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
- Vahendid hõivatakse, kui tellimus liigub olekusse completed
- Kui tellimus tühistatakse, tühistatakse autoriseerimine automaatselt
Kasutage käsitsi hõivamist, kui soovite klientidelt tasu võtta alles tellimuse saatmisel. See on kasulik pikemate täitmisaegadega kaupmeestele.
Silumise logimine
Kui Debug Logging on lubatud, kirjutab moodul faili nopayn_debug.log osCommerce logide kataloogis. Logikirjed sisaldavad:
- Kõik API päringud ja vastused
- Veebihaagi sündmused ja töötlemise tulemused
- Hõivamise ja tühistamise toimingud
- Vead (logitakse alati, olenemata silumise lülitist)
Kõik kirjed on eesliitega NoPayn_ lihtsaks filtreerimiseks.
Desinstallimine
- Minge halduspaneelis jaotisse Modules → Payment → Online
- Valige NoPayn Payments
- Klõpsake Remove
Mooduli desinstallimine eemaldab seadistuse ja kustutab andmebaasi tabelid nopayn_transactions ja nopayn_refunds. Veenduge, et ekspordite vajalikud andmed enne desinstallimist.
Testige ja käivitage
Tehke mõned testtehingud, et veenduda kõige sujuvas toimimises. Soovitame testida nii edukaid kui ebaõnnestunud makseid, et kinnitada kõigi stsenaariumide korrektset käsitlemist.
Tugi
Vajate abi? Võtke ühendust meie tugimeeskonnaga aadressil support@costplus.io.