Magento

Integruokite Cost+ kaip mokėjimo būdą savo Magento parduotuvėje. Cost+ plėtinys prieinamas Magento 2 (2.4.6 -- 2.4.8) ir Magento 1.9 (įskaitant OpenMage LTS 20+).

Būtinosios sąlygos

Aktyvi Cost+ prekybininko paskyra
Magento 2.4.6 -- 2.4.8 diegimas
PHP 8.2 -- 8.4
Administratoriaus prieiga prie jūsų Magento administravimo skydelio
SSH prieiga prie jūsų serverio (Composer diegimui)

Aktyvi Cost+ prekybininko paskyra
Magento 1.9.x arba OpenMage LTS 20+
PHP 7.4 arba naujesnė
Administratoriaus prieiga prie jūsų Magento administravimo skydelio
SSH arba FTP prieiga prie jūsų serverio

1. Įdiekite plėtinį

A būdas: Diegimas per Composer (rekomenduojama)

Prisijunkite prie savo Magento serverio per SSH ir eikite į Magento šakninį katalogą.

Įdiekite įskiepį:

composer require nopayn/nopayn-magento-2

Paleiskite Magento nustatymo komandas:

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

Jei esate produkcijos režime, taip pat paleiskite:

php bin/magento setup:static-content:deploy

B būdas: Rankinis diegimas

Eikite į savo app/code katalogą
Atsisiųskite ir išskleiskite Cost+ leidimą iš GitHub
Paleiskite nustatymo komandas:

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

Jei produkcijos režime:

php bin/magento setup:static-content:deploy

Atsisiųskite arba klonuokite modulį iš GitHub.

Nukopijuokite app/ turinį į savo Magento šakninį app/ katalogą:

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

Išvalykite Magento talpyklą:

rm -rf var/cache/*

Prisijunkite prie Magento administravimo skydelio ir eikite į System -> Configuration -> Sales -> Payment Methods, kad patikrintumėte, ar atsirado NoPayn Payment Gateway skyrius.

Modulis sukuria nopayn_transactions lentelę jūsų duomenų bazėje mokėjimo operacijoms sekti. Ji sukuriama automatiškai pirmo naudojimo metu.

2. Sukonfigūruokite įskiepį

Eikite į Stores -> Configuration -> Sales -> Payment Methods -> Cost+ Payments
Įveskite savo API raktą (žr. 3 žingsnį žemiau)
Įjunkite mokėjimo būdus, kuriems esate patvirtinti
Išsaugokite pakeitimus

Eikite į System -> Configuration -> Sales -> Payment Methods
Raskite NoPayn Payment Gateway skyrių
Įveskite savo API raktą (žr. 3 žingsnį žemiau)
Įjunkite atskirus mokėjimo būdus (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
Neprivaloma: apribokite pagal šalį
Išsaugokite konfigūraciją

3. Įveskite API kredencialus

Prisijunkite prie prekybininko portalo ir eikite į Websites, tada paspauskite svetainę, kurią norite prijungti. Paspauskite Integration, kur rasite savo API raktą.

Cost+ prekybininko portalas, rodantis API raktą

Įklijuokite API raktą į konfigūracijos lauką ir išsaugokite.

Aktyvuokite tik tuos mokėjimo būdus, kuriems esate patvirtinti ir gavote patvirtinimą.

Palaikomi mokėjimo būdai

Atsiskaitymo pavadinimas	NoPayn identifikatorius
Credit / Debit Card	`credit-card`
Apple Pay	`apple-pay`
Google Pay	`google-pay`
Vipps MobilePay	`vipps-mobilepay`

Mokėjimo procesas

Klientas pasirenka mokėjimo būdą atsiskaityme ir pateikia užsakymą
Klientas nukreipiamas į NoPayn mokėjimo puslapį
Po mokėjimo klientas grįžta ir užsakymo būsena atnaujinama automatiškai
NoPayn siunčia webhook asinchroniniam būsenos patvirtinimui

Klientas pasirenka mokėjimo būdą atsiskaityme ir pateikia užsakymą
Užsakymas sukuriamas su būsena Pending Payment
Klientas nukreipiamas į NoPayn saugų mokėjimo puslapį
Po mokėjimo:
- Sėkmingas — klientas grįžta, būsena patikrinama per API, užsakymas nustatomas kaip Processing
- Atšauktas — klientas grįžta, užsakymas nustatomas kaip Canceled
- Pasibaigęs (5 minučių limitas) — webhook suveikia, užsakymas nustatomas kaip Canceled
NoPayn siunčia webhook asinchroniniam būsenos patvirtinimui

Užsakymo būsenų atitikimas

NoPayn būsena	Magento užsakymo būklė	Magento užsakymo būsena
`new`	pending_payment	Pending Payment
`processing`	pending_payment	Pending Payment
`completed`	processing	Processing
`cancelled`	canceled	Canceled
`expired`	canceled	Canceled
`error`	canceled	Canceled

Modulis registruoja webhook galinį tašką adresu /nopayn/payment/webhook. Šis URL automatiškai siunčiamas NoPayn kuriant užsakymus. Webhook visada patikrina užsakymo būseną per NoPayn API prieš atnaujinant Magento užsakymą.

Rankinis webhook konfigūravimas nereikalingas — modulis tvarko registraciją automatiškai.

4. Testuokite savo nustatymus

Atlikite kelis testinius užsakymus — tiek sėkmingus, tiek nesėkmingus
Patikrinkite, kad visi įjungti mokėjimo būdai rodomi atsiskaityme
Sukonfigūruokite surinkimo elgesį (automatinis vs. rankinis) pagal jūsų vykdymo procesą

Palaikymas

Reikia pagalbos? Kreipkitės į mūsų palaikymo komandą adresu support@costplus.io.