Cost+Docs

Magento

Integrējiet Cost+ ar savu Magento veikalu (2.x un 1.9 / OpenMage LTS)

Magento

Integrējiet Cost+ kā maksājumu metodi savā Magento veikalā. Cost+ paplašinājums ir pieejams Magento 2 (2.4.6 – 2.4.8) un Magento 1.9 (ieskaitot OpenMage LTS 20+).

Priekšnosacījumi

  • Aktīvs Cost+ tirgotāja konts
  • Magento 2.4.6 – 2.4.8 instalācija
  • PHP 8.2 – 8.4
  • Administratora piekļuve jūsu Magento administrācijas panelim
  • SSH piekļuve jūsu serverim (Composer instalācijai)
  • Aktīvs Cost+ tirgotāja konts
  • Magento 1.9.x vai OpenMage LTS 20+
  • PHP 7.4 vai jaunāka versija
  • Administratora piekļuve jūsu Magento administrācijas panelim
  • SSH vai FTP piekļuve jūsu serverim

1. Instalējiet paplašinājumu

A metode: Instalācija caur Composer (ieteicams)

Pieslēdzieties savam Magento serverim caur SSH un dodieties uz Magento saknes direktoriju.

Instalējiet spraudni:

composer require nopayn/nopayn-magento-2

Izpildiet Magento iestatīšanas komandas:

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

Ja esat produkcijas režīmā, izpildiet arī:

php bin/magento setup:static-content:deploy

B metode: Manuāla instalācija

  1. Dodieties uz app/code direktoriju
  2. Lejupielādējiet un izpakojiet Cost+ laidienu no GitHub
  3. Izpildiet iestatīšanas komandas:
php bin/magento setup:upgrade
php bin/magento cache:clean

Ja produkcijas režīmā:

php bin/magento setup:static-content:deploy

Lejupielādējiet vai klonējiet moduli no GitHub.

Kopējiet app/ saturu jūsu Magento saknes app/ direktorijā:

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

Notīriet Magento kešatmiņu:

rm -rf var/cache/*

Piesakieties Magento administrācijas panelī un dodieties uz System → Configuration → Sales → Payment Methods, lai pārbaudītu, vai parādās sadaļa NoPayn Payment Gateway.

Modulis izveido nopayn_transactions tabulu jūsu datubāzē, lai izsekotu maksājumu darījumus. Tā tiek izveidota automātiski pirmajā lietošanas reizē.

2. Konfigurējiet spraudni

  1. Dodieties uz Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Ievadiet savu API atslēgu (skatiet 3. soli zemāk)
  3. Iespējojiet maksājumu metodes, kurām esat saņēmis apstiprinājumu
  4. Saglabājiet izmaiņas
  1. Dodieties uz System → Configuration → Sales → Payment Methods
  2. Atrodiet sadaļu NoPayn Payment Gateway
  3. Ievadiet savu API atslēgu (skatiet 3. soli zemāk)
  4. Iespējojiet atsevišķas maksājumu metodes (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
  5. Pēc izvēles ierobežojiet pēc valsts
  6. Saglabājiet konfigurāciju

3. Ievadiet API akreditācijas datus

Piesakieties tirgotāja portālā un dodieties uz Websites, tad noklikšķiniet uz vietnes, ko vēlaties savienot. Noklikšķiniet uz Integration, kur atradīsiet savu API atslēgu.

Cost+ tirgotāja portāls ar API atslēgu

Ielīmējiet API atslēgu konfigurācijas laukā un saglabājiet.

Aktivizējiet tikai tās maksājumu metodes, kurām esat saņēmis apstiprinājumu.

Atbalstītās maksājumu metodes

Norēķinu nosaukumsNoPayn identifikators
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Maksājuma plūsma

  1. Klients norēķinos atlasa maksājumu metodi un veic pasūtījumu
  2. Klients tiek novirzīts uz NoPayn mitināto maksājuma lapu
  3. Pēc maksājuma klients atgriežas un pasūtījuma statuss tiek automātiski atjaunināts
  4. NoPayn nosūta webhook asinhronai statusa apstiprināšanai
  1. Klients norēķinos atlasa maksājumu metodi un veic pasūtījumu
  2. Pasūtījums tiek izveidots ar statusu Pending Payment
  3. Klients tiek novirzīts uz NoPayn drošo maksājuma lapu
  4. Pēc maksājuma:
    • Veiksmīgs — klients atgriežas, statuss tiek verificēts caur API, pasūtījums iestatīts uz Processing
    • Atcelts — klients atgriežas, pasūtījums iestatīts uz Canceled
    • Beidzies termiņš (5 minūšu noildze) — webhook izsaukts, pasūtījums iestatīts uz Canceled
  5. NoPayn nosūta webhook asinhronai statusa apstiprināšanai

Pasūtījumu statusu atbilstība

NoPayn statussMagento pasūtījuma stāvoklisMagento pasūtījuma statuss
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhook

Modulis reģistrē webhook galapunktu /nopayn/payment/webhook. Šis URL tiek automātiski nosūtīts NoPayn, veidojot pasūtījumus. Webhook vienmēr verificē pasūtījuma statusu caur NoPayn API pirms Magento pasūtījuma atjaunināšanas.

Manuāla webhook konfigurācija nav nepieciešama — modulis apstrādā reģistrāciju automātiski.

4. Testējiet savu iestatījumu

  1. Veiciet dažus testa darījumus — gan veiksmīgus, gan neveiksmīgus
  2. Pārbaudiet, vai visas iespējotās maksājumu metodes parādās norēķinos
  3. Konfigurējiet iegūšanas uzvedību (automātiska iegūšana vai manuāla) atkarībā no jūsu izpildes procesa

Atbalsts

Nepieciešama palīdzība? Sazinieties ar mūsu atbalsta komandu: support@costplus.io.

On this page