DocsosCommerce
Integrējiet Cost+ ar savu osCommerce 4 veikalu, izmantojot oficiālo maksājumu moduli
Integrējiet Cost+ kā maksājumu metodi savā osCommerce 4 veikalā. Oficiālais NoPayn Payments modulis izmanto mitinātās maksājuma lapas plūsmu, tāpēc karšu dati nepieskaras jūsu serverim — pilnībā PCI DSS sertificēts.
Priekšnosacījumi
- Aktīvs Cost+ tirgotāja konts
- osCommerce 4.x
- PHP 8.1 vai jaunāka versija
- cURL paplašinājums iespējots
- SSL sertifikāts (HTTPS nepieciešams)
- Administratora piekļuve jūsu osCommerce administrācijas panelim
Atbalstītās maksājumu metodes
| Norēķinu etiķete | NoPayn identifikators |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Katru metodi var individuāli iespējot vai atspējot administrācijas panelī.
1. Instalējiet moduli
Lejupielādējiet vai klonējiet moduli no GitHub.
Kopējiet lib/ direktoriju savā osCommerce 4 saknē:
cp -r lib/ /path/to/oscommerce/Tas ievieto moduļa failus:
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.phpJūsu osCommerce administrācijas panelī:
- Dodieties uz Modules → Payment → Online
- Iespējojiet "Show inactive" un "Show not installed" filtrus, ja nepieciešams
- Atrodiet NoPayn Payments un noklikšķiniet Install
2. Konfigurējiet moduli
Piesakieties tirgotāja portālā un dodieties uz Websites, tad noklikšķiniet uz vietnes, ko vēlaties savienot. Noklikšķiniet uz Integration, kur atradīsiet savu API atslēgu.
Ievadiet savu API Key un konfigurējiet šādus iestatījumus:
| Iestatījums | Apraksts | Noklusējums |
|---|---|---|
| Enable NoPayn Payments | Galvenais iespējošanas/atspējošanas slēdzis | True |
| API Key | Jūsu NoPayn API atslēga | — |
| Enable Credit / Debit Card | Parādīt kredītkarti/debetkarti norēķinos | True |
| Enable Apple Pay | Parādīt Apple Pay norēķinos | True |
| Enable Google Pay | Parādīt Google Pay norēķinos | True |
| Enable Vipps MobilePay | Parādīt Vipps MobilePay norēķinos | True |
| Manual Capture (Credit Card) | Tikai autorizēt — iegūt, kad pasūtījums pabeigts | False |
| Debug Logging | Rakstīt API pieprasījumus/atbildes žurnālā | False |
| Completed Order Status | Statuss, kad maksājums veiksmīgs | Processing |
| Pending Order Status | Statuss, gaidot maksājumu | Pending |
| Cancelled Order Status | Statuss atcelšanas/neveiksmīga/termiņa beigšanās gadījumā | Cancelled |
| Payment Zone | Ierobežot ģeogrāfiskai zonai (neobligāti) | All zones |
| Sort Order | Attēlošanas secība norēķinu lapā | 0 |
Aktivizējiet tikai tās maksājumu metodes, kurām esat saņēmis apstiprinājumu.
3. Atjauniniet norēķinu etiķetes (ieteicams)
Noklusējuma osCommerce norēķinu pogu etiķetes pieņem vienpakāpes plūsmu. Labākai pieredzei ar ārējo maksājumu novirzīšanu atjauniniet šos tulkojumus Admin → Localisation → Languages → English → Define:
| Atslēga | Noklusējums | Ieteicams |
|---|---|---|
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 |
Tas uzlabo klienta pieredzi, padarot norēķinu plūsmu skaidrāku — klienti saprot, ka tiks novirzīti uz drošu lapu maksājuma pabeigšanai.
4. Maksājuma plūsma
Pēc konfigurēšanas maksājuma plūsma darbojas šādi:
- Klients norēķinos atlasa Cost+ maksājumu metodi
- Klients apstiprina pasūtījumu
- Modulis izveido neapstiprinātu pasūtījumu un izsauc Cost+ API
- Klients tiek novirzīts uz Cost+ mitināto maksājuma lapu (HPP)
- Klients pabeidz maksājumu drošajā HPP
- Klients tiek novirzīts atpakaļ uz veikalu
- Modulis verificē maksājuma statusu caur Cost+ API
- Pasūtījuma statuss tiek atjaunināts atbilstoši
Maksājuma saišu termiņš beidzas pēc 5 minūtēm. Ja klients nepabeidz maksājumu šajā laika logā, pasūtījums tiek automātiski atzīmēts kā atcelts.
5. Webhook
Modulis reģistrē webhook URL ar Cost+ servera-servera statusa atjauninājumiem. Kad mainās maksājuma statuss, Cost+ nosūta paziņojumu un modulis:
- Saņem webhook POST
- Verificē maksājuma statusu caur API (nekad neuzticas tikai webhook saturam)
- Atjaunina pasūtījuma statusu osCommerce sistēmā
Manuāla webhook konfigurācija nav nepieciešama — modulis apstrādā reģistrāciju automātiski.
Manuāla iegūšana
Kad iespējota kredītkaršu maksājumiem:
- Maksājums tiek autorizēts, bet netiek iegūts norēķinos
- Līdzekļi tiek iegūti, kad pasūtījums pāriet uz completed statusu
- Ja pasūtījums tiek atcelts, autorizācija automātiski tiek anulēta
Izmantojiet manuālu iegūšanu, ja vēlaties iekasēt no klientiem tikai tad, kad viņu pasūtījums tiek nosūtīts. Tas ir noderīgi tirgotājiem ar ilgāku izpildes laiku.
Atkļūdošanas reģistrēšana
Kad Debug Logging ir iespējota, modulis raksta nopayn_debug.log failā osCommerce žurnālu direktorijā. Žurnāla ieraksti ietver:
- Visus API pieprasījumus un atbildes
- Webhook notikumus un apstrādes rezultātus
- Iegūšanas un anulēšanas operācijas
- Kļūdas (vienmēr reģistrētas, neatkarīgi no atkļūdošanas slēdža)
Visi ieraksti ir ar prefiksu NoPayn_ ērtai filtrēšanai.
Atinstalēšana
- Dodieties uz Modules → Payment → Online administrācijas panelī
- Atlasiet NoPayn Payments
- Noklikšķiniet Remove
Moduļa atinstalēšana noņem konfigurāciju un dzēš nopayn_transactions un nopayn_refunds datubāzes tabulas. Pārliecinieties, ka eksportējat visus nepieciešamos datus pirms atinstalēšanas.
Testēšana un palaišana
Veiciet dažus testa darījumus, lai pārliecinātos, ka viss darbojas gludi. Iesakām testēt gan veiksmīgus, gan neveiksmīgus maksājumus, lai apstiprinātu visu scenāriju pareizu apstrādi.
Atbalsts
Nepieciešama palīdzība? Sazinieties ar mūsu atbalsta komandu: support@costplus.io.