DocsOpenCart
Integrējiet Cost+ ar savu OpenCart veikalu (4.x un 3.x / ocStore 3)
Integrējiet Cost+ kā maksājumu metodi savā OpenCart veikalā. Oficiālais NoPayn Payment Gateway paplašinājums ir pieejams OpenCart 4 un OpenCart 3 / ocStore 3.
Priekšnosacījumi
- Aktīvs Cost+ tirgotāja konts
- OpenCart 4.0.0.0 vai jaunāka versija
- PHP 8.0 vai jaunāka versija
- Administratora piekļuve jūsu OpenCart vadības panelim
- Aktīvs Cost+ tirgotāja konts
- ocStore 3.0.x vai OpenCart 3.0.3.x
- PHP 7.4 vai jaunāka versija
- Administratora piekļuve jūsu OpenCart vadības panelim
Atbalstītās maksājumu metodes
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Credit / Debit Card — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
- Apple Pay
- Google Pay
- Vipps / MobilePay
- Swish
1. Instalējiet paplašinājumu
A metode: Augšupielāde caur administrācijas paneli (ieteicams)
- Lejupielādējiet jaunāko
.ocmod.ziplaidienu no GitHub - OpenCart administrācijā dodieties uz Extensions → Installer
- Augšupielādējiet
.ocmod.zipfailu - Dodieties uz Extensions → Extensions → Payment
- Atrodiet NoPayn Payment Gateway un noklikšķiniet Install, tad Edit
B metode: Manuāla augšupielāde
- Lejupielādējiet vai klonējiet repozitoriju
- Kopējiet
upload/mapes saturu jūsu OpenCart saknes direktorijā - Dodieties uz Extensions → Extensions → Payment
- Atrodiet NoPayn Payment Gateway un noklikšķiniet Install, tad Edit
Arhitektūra
OpenCart 3 izmanto vairāku paplašinājumu iestatījumu:
- NoPayn - Global Settings — kopīga konfigurācija (API atslēga, pasūtījumu statusi, metožu pieejamība, manuāla iegūšana, atkļūdošanas reģistrēšana)
- NoPayn - Card Payments — kredītkaršu/debetkaršu norēķini
- NoPayn - Apple Pay / Google Pay — maku norēķini (ja iespējots tikai viens maciņš, etiķete pielāgojas automātiski)
- NoPayn - Vipps MobilePay — Vipps/MobilePay norēķini
- NoPayn - Swish — Swish norēķini
A metode: Augšupielāde caur administrācijas paneli (ieteicams)
- Lejupielādējiet
.ocmod.zipaktīvu no jaunākā GitHub laidiena
Izmantojiet .ocmod.zip aktīvu no laidiena — nevis GitHub automātiski ģenerētās "Source code" lejupielādes, kas satur repozitorija izkārtojumu, nevis instalētāja izkārtojumu.
- Administrācijā dodieties uz Extensions → Installer
- Augšupielādējiet
.ocmod.zipfailu - Dodieties uz Extensions → Extensions → Payments
- Vispirms instalējiet NoPayn - Global Settings
- Atveriet NoPayn - Global Settings un konfigurējiet:
- API atslēgu
- Pabeigto, neapstiprināto un atcelto pasūtījumu statusus
- Pieejamās maksājumu metodes, kurām jūsu tirgotāja konts ir apstiprināts
- Pēc izvēles: karšu manuāla iegūšana
- Pēc izvēles: atkļūdošanas reģistrēšana
- Instalējiet norēķinu moduļus, kurus vēlaties parādīt:
- NoPayn - Card Payments
- NoPayn - Apple Pay / Google Pay
- NoPayn - Vipps MobilePay
- NoPayn - Swish
- Katram norēķinu modulim iestatiet: Status, Geo Zone un Sort Order
B metode: Manuāla augšupielāde
- Lejupielādējiet vai klonējiet repozitoriju
- Kopējiet
upload/mapes saturu jūsu veikala saknē - Dodieties uz Extensions → Extensions → Payments
- Izpildiet to pašu instalācijas secību kā A metodē (vispirms Global Settings, tad norēķinu moduļi)
2. Ievadiet API akreditācijas datus
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.
NoPayn Payment Gateway iestatījumos ievadiet savu API Key atbilstošajā laukā.
NoPayn - Global Settings ievadiet savu API Key atbilstošajā laukā. API atslēga tiek kopīgota starp visiem norēķinu moduļiem — tā jāievada tikai vienu reizi.
3. Konfigurējiet maksājumu iestatījumus
- Iespējojiet maksājumu metodes, kurām esat saņēmis apstiprinājumu
- Iestatiet vēlamos pasūtījumu statusus pabeigtiem, neapstiprinātiem un atceltiem maksājumiem
- Pēc izvēles ierobežojiet maksājumus pēc Geo Zone
- Iestatiet Status uz Enabled
- Noklikšķiniet Save
Globālie iestatījumi
NoPayn - Global Settings glabā visu kopīgo konfigurāciju:
| Iestatījums | Apraksts |
|---|---|
| API Key | Jūsu NoPayn API atslēga |
| Order Statuses | Pabeigto, neapstiprināto un atcelto statusu atbilstība |
| Method Availability | Kuras maksājumu metodes ir apstiprinātas jūsu tirgotāja kontam |
| Manual Capture | Autorizēt tikai kredītkaršu maksājumus — iegūt vēlāk |
| Debug Logging | Iespējot detalizētu reģistrēšanu problēmu novēršanai |
Norēķinu moduļu iestatījumi
Katram norēķinu modulim ir savi veikala iestatījumi:
| Iestatījums | Apraksts |
|---|---|
| Status | Iespējot vai atspējot šo maksājumu metodi norēķinos |
| Geo Zone | Ierobežot noteiktām ģeogrāfiskām zonām |
| Sort Order | Attēlošanas secība norēķinu lapā |
Aktivizējiet tikai tās maksājumu metodes, kurām esat saņēmis apstiprinājumu.
Maksājuma plūsma
- Klients norēķinos atlasa Cost+ maksājumu metodi
- Klients tiek novirzīts uz NoPayn mitināto maksājuma lapu
- Pēc maksājuma klients atgriežas un pasūtījuma statuss tiek automātiski atjaunināts
- NoPayn nosūta webhook asinhronai statusa apstiprināšanai
Paplašinājums izmanto Cost+ mitināto maksājuma lapu, kas nozīmē, ka klienti tiek novirzīti uz drošu maksājuma formu. Jūsu serveris neapstrādā sensitīvus karšu datus.
Katrs norēķinu modulis ir atsevišķs OpenCart maksājumu paplašinājums, kas klientiem piedāvā atsevišķas radio opcijas norēķinos (piemēram, "Card Payments", "Apple Pay & Google Pay").
- Klients norēķinos atlasa maksājumu metodes etiķeti (piemēram, Card Payments)
- Paplašinājums izveido NoPayn mitinātā maksājuma pasūtījumu
- Klients tiek novirzīts uz drošo NoPayn maksājuma lapu
- Pēc maksājuma klients atgriežas un pasūtījuma statuss tiek automātiski atjaunināts
- NoPayn nosūta webhook asinhronai statusa apstiprināšanai
Apple Pay / Google Pay modulis nosūta abas metodes vienā darījumā, lai NoPayn mitinātā lapa varētu piedāvāt abus maciņa variantus vienā plūsmā.
Jaunināšana no v1.0.0 uz v2.0.0
Versija 1.0.0 izmantoja vienu norēķinu metodi ar nosaukumu "NoPayn Checkout". Versija 2.0.0 maina to uz atsevišķiem norēķinu moduļiem katrai maksājumu metodei. Jauninot:
- Augšupielādējiet jauno pakotni
- Jūsu esošais "NoPayn Checkout" ieraksts kļūst par NoPayn - Global Settings
- Pārskatiet un saglabājiet globālos iestatījumus
- Instalējiet un iespējojiet jaunos norēķinu moduļus, kurus vēlaties parādīt klientiem
4. 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.