Cost+Docs

Magento

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

Magento

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-2

Pokrenite Magento naredbe za postavljanje:

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

Ako ste u produkcijskom načinu, također pokrenite:

php bin/magento setup:static-content:deploy

Metoda B: Ručna instalacija

  1. Idite u svoj app/code direktorij
  2. Preuzmite i raspakirajte Cost+ izdanje s GitHuba
  3. Pokrenite naredbe za postavljanje:
php bin/magento setup:upgrade
php bin/magento cache:clean

Ako ste u produkcijskom načinu:

php bin/magento setup:static-content:deploy

Preuzmite 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

  1. Idite na Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Unesite svoj API ključ (pogledajte korak 3 u nastavku)
  3. Omogućite načine plaćanja za koje ste odobreni
  4. Spremite promjene
  1. Idite na System → Configuration → Sales → Payment Methods
  2. Pronađite odjeljak NoPayn Payment Gateway
  3. Unesite svoj API ključ (pogledajte korak 3 u nastavku)
  4. Omogućite pojedine načine plaćanja (kreditna/debitna kartica, Apple Pay, Google Pay, Vipps MobilePay)
  5. Opcionalno ograničite po zemlji
  6. 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č.

Cost+ portal trgovca s prikazom API ključa

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 blagajniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Tijek plaćanja

  1. Kupac odabire način plaćanja na blagajni i naručuje
  2. Kupac se preusmjerava na NoPayn hosted stranicu za plaćanje
  3. Nakon plaćanja, kupac se vraća i status narudžbe se automatski ažurira
  4. NoPayn šalje webhook za asinkronu potvrdu statusa
  1. Kupac odabire način plaćanja na blagajni i naručuje
  2. Narudžba se stvara sa statusom Pending Payment
  3. Kupac se preusmjerava na sigurnu NoPayn stranicu za plaćanje
  4. 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
  5. NoPayn šalje webhook za asinkronu potvrdu statusa

Mapiranje statusa narudžbe

NoPayn statusMagento stanje narudžbeMagento status narudžbe
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

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

  1. Napravite nekoliko testnih transakcija — i uspješnih i neuspjelih
  2. Provjerite pojavljuju li se svi omogućeni načini plaćanja na blagajni
  3. 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.

On this page