Magento
Integrirajte Cost+ sa svojom Magento trgovinom (2.x i 1.9 / OpenMage LTS)

Integrirajte Cost+ kao način plaćanja u svojoj Magento trgovini. Cost+ proširenje dostupno je za Magento 2 (2.4.6 -- 2.4.8) i Magento 1.9 (uključujući OpenMage LTS 20+).
Preduvjeti
- Aktivan Cost+ trgovački račun
- Magento 2.4.6 -- 2.4.8 instalacija
- PHP 8.2 -- 8.4
- Administratorski pristup vašoj Magento administratorskoj ploči
- SSH pristup vašem poslužitelju (za Composer instalaciju)
- Aktivan Cost+ trgovački račun
- Magento 1.9.x ili OpenMage LTS 20+
- PHP 7.4 ili noviji
- Administratorski pristup vašoj Magento administratorskoj ploči
- SSH ili FTP pristup vašem poslužitelju
1. Instalirajte proširenje
Metoda A: Instalacija putem Composera (preporučeno)
Povežite se na svoj Magento poslužitelj putem SSH-a i idite u korijenski direktorij Magenta.
Instalirajte dodatak:
composer require nopayn/nopayn-magento-2Pokrenite Magento naredbe za postavljanje:
php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:cleanAko ste u produkcijskom načinu, također pokrenite:
php bin/magento setup:static-content:deployMetoda B: Ručna instalacija
- Idite u svoj
app/codedirektorij - Preuzmite i raspakirajte Cost+ izdanje s GitHuba
- Pokrenite naredbe za postavljanje:
php bin/magento setup:upgrade
php bin/magento cache:cleanAko ste u produkcijskom načinu:
php bin/magento setup:static-content:deployPreuzmite ili klonirajte modul s GitHuba.
Kopirajte sadržaj app/ u korijenski app/ direktorij vašeg Magenta:
cp -r app/* /path/to/magento/app/Očistite Magento predmemoriju:
rm -rf var/cache/*Prijavite se u Magento administratorsku ploču i idite na System → Configuration → Sales → Payment Methods kako biste provjerili pojavljuje li se odjeljak NoPayn Payment Gateway.
Modul stvara tablicu nopayn_transactions u vašoj bazi podataka za praćenje platnih transakcija. Ovo se automatski stvara pri prvoj upotrebi.
2. Konfigurirajte dodatak
- Idite na Stores → Configuration → Sales → Payment Methods → Cost+ Payments
- Unesite svoj API ključ (pogledajte korak 3 u nastavku)
- Omogućite načine plaćanja za koje ste odobreni
- Spremite promjene
- Idite na System → Configuration → Sales → Payment Methods
- Pronađite odjeljak NoPayn Payment Gateway
- Unesite svoj API ključ (pogledajte korak 3 u nastavku)
- Omogućite pojedine načine plaćanja (kreditna/debitna kartica, Apple Pay, Google Pay, Vipps MobilePay)
- Opcionalno ograničite po zemlji
- Spremite konfiguraciju
3. Unesite API vjerodajnice
Prijavite se u portal trgovca i idite na Websites, zatim kliknite na web stranicu koju želite povezati. Kliknite na Integration gdje ćete pronaći svoj API ključ.

Zalijepite API ključ u polje za konfiguraciju i spremite.
Aktivirajte samo one načine plaćanja za koje ste odobreni i za koje ste primili potvrdu.
Podržani načini plaćanja
| Naziv na blagajni | NoPayn identifikator |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Tijek plaćanja
- Kupac odabire način plaćanja na blagajni i naručuje
- Kupac se preusmjerava na NoPayn hosted stranicu za plaćanje
- Nakon plaćanja, kupac se vraća i status narudžbe se automatski ažurira
- NoPayn šalje webhook za asinkronu potvrdu statusa
- Kupac odabire način plaćanja na blagajni i naručuje
- Narudžba se stvara sa statusom Pending Payment
- Kupac se preusmjerava na sigurnu NoPayn stranicu za plaćanje
- Nakon plaćanja:
- Uspjeh — kupac se vraća, status se provjerava putem API-ja, narudžba postavljena na Processing
- Poništeno — kupac se vraća, narudžba postavljena na Canceled
- Isteklo (vremensko ograničenje od 5 minuta) — webhook se aktivira, narudžba postavljena na Canceled
- NoPayn šalje webhook za asinkronu potvrdu statusa
Mapiranje statusa narudžbe
| NoPayn status | Magento stanje narudžbe | Magento status narudžbe |
|---|---|---|
new | pending_payment | Pending Payment |
processing | pending_payment | Pending Payment |
completed | processing | Processing |
cancelled | canceled | Canceled |
expired | canceled | Canceled |
error | canceled | Canceled |
Webhookovi
Modul registrira webhook krajnju točku na /nopayn/payment/webhook. Ovaj URL se automatski šalje NoPaynu prilikom stvaranja narudžbi. Webhook uvijek provjerava status narudžbe putem NoPayn API-ja prije ažuriranja Magento narudžbe.
Ručna konfiguracija webhookova nije potrebna — modul automatski upravlja registracijom.
4. Testirajte postavljanje
- Napravite nekoliko testnih transakcija — i uspješnih i neuspjelih
- Provjerite pojavljuju li se svi omogućeni načini plaćanja na blagajni
- Konfigurirajte ponašanje naplate (automatska naplata naspram ručne) ovisno o vašem procesu ispunjenja
Podrška
Trebate pomoć? Obratite se našem timu za podršku na support@costplus.io.