Magento

Integreerige Cost+ makseviisina oma Magento poega. Cost+ laiendus on saadaval Magento 2 (2.4.6 – 2.4.8) ja Magento 1.9 (sealhulgas OpenMage LTS 20+) jaoks.

Eeldused

Aktiivne Cost+ kaupmehe konto
Magento 2.4.6 – 2.4.8 paigaldus
PHP 8.2 – 8.4
Administraatori juurdepääs teie Magento halduspaneelile
SSH-juurdepääs teie serverile (Composeri paigaldamiseks)

Aktiivne Cost+ kaupmehe konto
Magento 1.9.x või OpenMage LTS 20+
PHP 7.4 või uuem
Administraatori juurdepääs teie Magento halduspaneelile
SSH- või FTP-juurdepääs teie serverile

1. Paigaldage laiendus

Meetod A: Paigaldamine Composeri kaudu (soovitatav)

Ühenduge oma Magento serveriga SSH kaudu ja navigeerige oma Magento juurkataloogi.

Paigaldage plugin:

composer require nopayn/nopayn-magento-2

Käivitage Magento seadistuskäsud:

php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:clean

Kui olete tootmisrežiimis, käivitage ka:

php bin/magento setup:static-content:deploy

Meetod B: Käsitsi paigaldamine

Navigeerige oma app/code kataloogi
Laadige alla ja pakkige lahti Cost+ väljalase GitHubist
Käivitage seadistuskäsud:

php bin/magento setup:upgrade
php bin/magento cache:clean

Tootmisrežiimis:

php bin/magento setup:static-content:deploy

Laadige alla või kloonige moodul GitHubist.

Kopeerige app/ sisu oma Magento juurkataloogi app/ kausta:

cp -r app/* /path/to/magento/app/

Tühjendage Magento vahemälu:

rm -rf var/cache/*

Logige sisse Magento halduspaneeli ja navigeerige jaotisse System → Configuration → Sales → Payment Methods, et kontrollida, kas jaotis NoPayn Payment Gateway kuvatakse.

Moodul loob teie andmebaasi tabeli nopayn_transactions maksetehingute jälgimiseks. See luuakse automaatselt esimesel kasutamisel.

2. Seadistage plugin

Minge jaotisse Stores → Configuration → Sales → Payment Methods → Cost+ Payments
Sisestage oma API võti (vt 3. samm allpool)
Lubage makseviisid, mille jaoks olete kinnituse saanud
Salvestage muudatused

Minge jaotisse System → Configuration → Sales → Payment Methods
Leidke jaotis NoPayn Payment Gateway
Sisestage oma API võti (vt 3. samm allpool)
Lubage üksikud makseviisid (krediit-/deebetkaart, Apple Pay, Google Pay, Vipps MobilePay)
Valikuliselt piirake riikide järgi
Salvestage seadistus

3. Sisestage API mandaadid

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.

Cost+ kaupmehe portaal näitab API võtit

Kleepige API võti seadistusväljale ja salvestage.

Aktiveerige ainult makseviisid, mille jaoks olete saanud kinnituse.

Toetatud makseviisid

Kassa nimi	NoPayn identifikaator
Credit / Debit Card	`credit-card`
Apple Pay	`apple-pay`
Google Pay	`google-pay`
Vipps MobilePay	`vipps-mobilepay`

Maksevoog

Klient valib kassas makseviisi ja esitab tellimuse
Klient suunatakse NoPayn hostitud makselehele
Pärast maksmist naaseb klient ja tellimuse olek uuendatakse automaatselt
NoPayn saadab veebihaagi asünkroonseks oleku kinnitamiseks

Klient valib kassas makseviisi ja esitab tellimuse
Tellimus luuakse olekuga Pending Payment
Klient suunatakse NoPayn turvalise makselehe lehele
Pärast maksmist:
- Edukas — klient naaseb, olek kinnitatakse API kaudu, tellimus seatakse olekusse Processing
- Tühistatud — klient naaseb, tellimus seatakse olekusse Canceled
- Aegunud (5-minutiline ajalõpp) — veebihaak käivitub, tellimus seatakse olekusse Canceled
NoPayn saadab veebihaagi asünkroonseks oleku kinnitamiseks

Tellimuse oleku vastendamine

NoPayn olek	Magento tellimuse seisund	Magento tellimuse olek
`new`	pending_payment	Pending Payment
`processing`	pending_payment	Pending Payment
`completed`	processing	Processing
`cancelled`	canceled	Canceled
`expired`	canceled	Canceled
`error`	canceled	Canceled

Moodul registreerib veebihaagi lõpp-punkti aadressil /nopayn/payment/webhook. See URL saadetakse automaatselt NoPayn-ile tellimuste loomisel. Veebihaak kontrollib alati tellimuse olekut NoPayn API kaudu enne Magento tellimuse uuendamist.

Käsitsi veebihaagi seadistamist pole vaja — moodul käsitleb registreerimist automaatselt.

4. Testige oma seadistust

Tehke mõned testtehingud — nii edukad kui ebaõnnestunud
Kontrollige, et kõik lubatud makseviisid kuvatakse kassas
Seadistage hõivamise käitumine (automaat-hõivamine vs käsitsi) vastavalt oma täitmisprotsessile

Tugi

Vajate abi? Võtke ühendust meie tugimeeskonnaga aadressil support@costplus.io.