DocsosCommerce
Integruokite Cost+ su savo osCommerce 4 parduotuve naudodami oficialų mokėjimo modulį
Integruokite Cost+ kaip mokėjimo būdą savo osCommerce 4 parduotuvėje. Oficialus NoPayn Payments modulis naudoja mokėjimo puslapio procesą, todėl jokia kortelių informacija nepaliečia jūsų serverio — visiškai PCI DSS atitinkantis.
Būtinosios sąlygos
- Aktyvi Cost+ prekybininko paskyra
- osCommerce 4.x
- PHP 8.1 arba naujesnė
- cURL plėtinys įjungtas
- SSL sertifikatas (HTTPS privalomas)
- Administratoriaus prieiga prie jūsų osCommerce administravimo skydelio
Palaikomi mokėjimo būdai
| Atsiskaitymo etiketė | NoPayn identifikatorius |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Kiekvienas būdas gali būti atskirai įjungtas arba išjungtas iš administravimo skydelio.
1. Įdiekite modulį
Atsisiųskite arba klonuokite modulį iš GitHub.
Nukopijuokite lib/ katalogą į savo osCommerce 4 šakninį katalogą:
cp -r lib/ /path/to/oscommerce/Tai patalpina modulio failus adresu:
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.phpSavo osCommerce administravimo skydelyje:
- Eikite į Modules -> Payment -> Online
- Įjunkite "Show inactive" ir "Show not installed" filtrus, jei reikia
- Raskite NoPayn Payments ir paspauskite Install
2. Sukonfigūruokite modulį
Prisijunkite prie prekybininko portalo ir eikite į Websites, tada paspauskite svetainę, kurią norite prijungti. Paspauskite Integration, kur rasite savo API raktą.
Įveskite savo API raktą ir sukonfigūruokite šiuos nustatymus:
| Nustatymas | Aprašymas | Numatytasis |
|---|---|---|
| Enable NoPayn Payments | Pagrindinis įjungimo/išjungimo jungiklis | True |
| API Key | Jūsų NoPayn API raktas | — |
| Enable Credit / Debit Card | Rodyti kreditinę/debetinę kortelę atsiskaityme | True |
| Enable Apple Pay | Rodyti Apple Pay atsiskaityme | True |
| Enable Google Pay | Rodyti Google Pay atsiskaityme | True |
| Enable Vipps MobilePay | Rodyti Vipps MobilePay atsiskaityme | True |
| Manual Capture (Credit Card) | Tik autorizuoti — surinkti, kai užsakymas užbaigtas | False |
| Debug Logging | Rašyti API užklausas/atsakymus į žurnalą | False |
| Completed Order Status | Būsena, kai mokėjimas pavyksta | Processing |
| Pending Order Status | Būsena laukiant mokėjimo | Pending |
| Cancelled Order Status | Būsena atšaukimo/nesėkmės/galiojimo pabaigos atveju | Cancelled |
| Payment Zone | Apriboti geografinei zonai (neprivaloma) | Visos zonos |
| Sort Order | Rodymo tvarka atsiskaitymo puslapyje | 0 |
Aktyvuokite tik tuos mokėjimo būdus, kuriems esate patvirtinti ir gavote patvirtinimą.
3. Atnaujinkite atsiskaitymo etiketes (rekomenduojama)
Numatytosios osCommerce atsiskaitymo mygtukų etiketės numato vieno žingsnio procesą. Geresnei patirčiai su nukreipimu į mokėjimo puslapį, atnaujinkite šiuos vertimus Admin -> Localisation -> Languages -> English -> Define:
| Raktas | Numatytasis | Rekomenduojamas |
|---|---|---|
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 |
Tai pagerina klientų patirtį, nes atsiskaitymo procesas tampa aiškesnis — klientai supranta, kad bus nukreipti mokėjimui saugiame puslapyje.
4. Mokėjimo procesas
Sukonfigūravus, mokėjimo procesas veikia taip:
- Klientas pasirenka Cost+ mokėjimo būdą atsiskaityme
- Klientas patvirtina užsakymą
- Modulis sukuria laukiantį užsakymą ir iškviečia Cost+ API
- Klientas nukreipiamas į Cost+ mokėjimo puslapį (HPP)
- Klientas atlieka mokėjimą saugiame HPP
- Klientas nukreipiamas atgal į parduotuvę
- Modulis patikrina mokėjimo būseną per Cost+ API
- Užsakymo būsena atnaujinama atitinkamai
Mokėjimo nuorodos baigiasi po 5 minučių. Jei klientas neužbaigia mokėjimo per šį laikotarpį, užsakymas automatiškai pažymimas kaip atšauktas.
5. Webhooks
Modulis registruoja webhook URL su Cost+ serveris-serveriui būsenos atnaujinimams. Kai mokėjimo būsena pasikeičia, Cost+ siunčia pranešimą ir modulis:
- Gauna webhook POST
- Patikrina mokėjimo būseną per API (niekada nepasitiki webhook turiniu)
- Atnaujina užsakymo būseną osCommerce
Rankinis webhook konfigūravimas nereikalingas — modulis tvarko registraciją automatiškai.
Rankinis surinkimas
Kai įjungtas kreditinių kortelių mokėjimams:
- Mokėjimas autorizuojamas, bet nesurenkamas atsiskaityme
- Lėšos surenkamos, kai užsakymas pereina į completed būseną
- Jei užsakymas atšaukiamas, autorizacija automatiškai anuliuojama
Naudokite rankinį surinkimą, jei norite apmokestinti klientus tik kai jų užsakymas išsiunčiamas. Tai naudinga prekybininkams su ilgesniu vykdymo laiku.
Derinimo registravimas
Kai Debug Logging įjungtas, modulis rašo į nopayn_debug.log osCommerce žurnalų kataloge. Žurnalo įrašai apima:
- Visas API užklausas ir atsakymus
- Webhook įvykius ir apdorojimo rezultatus
- Surinkimo ir anuliavimo operacijas
- Klaidas (visada registruojamos, nepriklausomai nuo derinimo jungiklio)
Visi įrašai yra su NoPayn_ priešdėliu lengvam filtravimui.
Pašalinimas
- Eikite į Modules -> Payment -> Online administravimo skydelyje
- Pasirinkite NoPayn Payments
- Paspauskite Remove
Pašalinus modulį bus pašalinta konfigūracija ir ištrintos nopayn_transactions ir nopayn_refunds duomenų bazės lentelės. Įsitikinkite, kad eksportavote reikalingus duomenis prieš pašalinimą.
Testuokite ir paleiskite
Atlikite kelis testinius užsakymus, kad įsitikintumėte, jog viskas veikia sklandžiai. Rekomenduojame testuoti tiek sėkmingus, tiek nesėkmingus mokėjimus, kad patvirtintumėte teisingą visų scenarijų tvarkymą.
Palaikymas
Reikia pagalbos? Kreipkitės į mūsų palaikymo komandą adresu support@costplus.io.