Cost+Docs

Magento

Integrirajte Cost+ s svojo Magento trgovino (2.x in 1.9 / OpenMage LTS)

Magento

Integrirajte Cost+ kot plačilno metodo v svojo Magento trgovino. Razširitev Cost+ je na voljo za Magento 2 (2.4.6 – 2.4.8) in Magento 1.9 (vključno z OpenMage LTS 20+).

Predpogoji

  • Aktiven trgovski račun Cost+
  • Namestitev Magento 2.4.6 – 2.4.8
  • PHP 8.2 – 8.4
  • Skrbniški dostop do vaše Magento skrbniške plošče
  • SSH dostop do vašega strežnika (za namestitev prek Composer)
  • Aktiven trgovski račun Cost+
  • Magento 1.9.x ali OpenMage LTS 20+
  • PHP 7.4 ali novejši
  • Skrbniški dostop do vaše Magento skrbniške plošče
  • SSH ali FTP dostop do vašega strežnika

1. Namestite razširitev

Način A: Namestitev prek Composer (priporočeno)

Povežite se na vaš Magento strežnik prek SSH in pojdite v korenski imenik Magento.

Namestite vtičnik:

composer require nopayn/nopayn-magento-2

Zaženite ukaze za nastavitev Magento:

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

Če ste v produkcijskem načinu, zaženite tudi:

php bin/magento setup:static-content:deploy

Način B: Ročna namestitev

  1. Pojdite v imenik app/code
  2. Prenesite in razpakirajte izdajo Cost+ z GitHub
  3. Zaženite ukaze za nastavitev:
php bin/magento setup:upgrade
php bin/magento cache:clean

Če ste v produkcijskem načinu:

php bin/magento setup:static-content:deploy

Prenesite ali klonirajte modul z GitHub.

Kopirajte vsebino mape app/ v korensko mapo app/ vaše Magento namestitve:

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

Počistite predpomnilnik Magento:

rm -rf var/cache/*

Prijavite se v skrbniško ploščo Magento in pojdite na System → Configuration → Sales → Payment Methods za preverjanje, da se razdelek NoPayn Payment Gateway prikaže.

Modul ustvari tabelo nopayn_transactions v vaši podatkovni bazi za sledenje plačilnih transakcij. Ta se ustvari samodejno ob prvi uporabi.

2. Konfigurirajte vtičnik

  1. Pojdite na Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Vnesite vaš API ključ (glejte korak 3 spodaj)
  3. Omogočite plačilne metode, za katere ste bili odobreni
  4. Shranite spremembe
  1. Pojdite na System → Configuration → Sales → Payment Methods
  2. Poiščite razdelek NoPayn Payment Gateway
  3. Vnesite vaš API ključ (glejte korak 3 spodaj)
  4. Omogočite posamezne plačilne metode (kreditna/debetna kartica, Apple Pay, Google Pay, Vipps MobilePay)
  5. Po želji omejite po državah
  6. Shranite konfiguracijo

3. Vnesite API poverilnice

Prijavite se v portal trgovca in pojdite na Spletna mesta, nato kliknite na spletno mesto, ki ga želite povezati. Kliknite na Integracija, kjer boste našli vaš API ključ.

Portal trgovca Cost+ s prikazom API ključa

Prilepite API ključ v konfiguracijsko polje in shranite.

Aktivirajte samo plačilne metode, za katere ste bili odobreni in ste prejeli potrditev.

Podprte plačilne metode

Ime na blagajniNoPayn identifikator
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Tok plačila

  1. Stranka izbere plačilno metodo na blagajni in odda naročilo
  2. Stranka je preusmerjena na gostovano plačilno stran NoPayn
  3. Po plačilu se stranka vrne in status naročila se samodejno posodobi
  4. NoPayn pošlje webhook za asinhrono potrditev statusa
  1. Stranka izbere plačilno metodo na blagajni in odda naročilo
  2. Naročilo je ustvarjeno s statusom Čakajoče plačilo
  3. Stranka je preusmerjena na varno plačilno stran NoPayn
  4. Po plačilu:
    • Uspeh — stranka se vrne, status se preveri prek API-ja, naročilo nastavljeno na V obdelavi
    • Preklicano — stranka se vrne, naročilo nastavljeno na Preklicano
    • Poteklo (5-minutna časovna omejitev) — webhook sproži, naročilo nastavljeno na Preklicano
  5. NoPayn pošlje webhook za asinhrono potrditev statusa

Preslikava statusov naročila

NoPayn statusMagento stanje naročilaMagento status naročila
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhook-i

Modul registrira končno točko webhook-a na /nopayn/payment/webhook. Ta URL se samodejno pošlje NoPayn ob ustvarjanju naročil. Webhook vedno preveri status naročila prek NoPayn API pred posodobitvijo naročila Magento.

Ročna konfiguracija webhook-a ni potrebna — modul samodejno obravnava registracijo.

4. Testirajte svojo nastavitev

  1. Izvedite nekaj testnih transakcij — tako uspešnih kot neuspešnih
  2. Preverite, da se vse omogočene plačilne metode prikažejo na blagajni
  3. Konfigurirajte obnašanje zajema (samodejni zajem ali ročni) glede na vaš proces izpolnjevanja

Podpora

Potrebujete pomoč? Obrnite se na našo ekipo za podporo na support@costplus.io.

On this page