Cost+Docs

Magento

Integrați Cost+ cu magazinul dvs. Magento (2.x și 1.9 / OpenMage LTS)

Magento

Integrați Cost+ ca metodă de plată în magazinul dvs. Magento. Extensia Cost+ este disponibilă pentru Magento 2 (2.4.6 -- 2.4.8) și Magento 1.9 (inclusiv OpenMage LTS 20+).

Cerințe preliminare

  • Cont activ de comerciant Cost+
  • Instalare Magento 2.4.6 -- 2.4.8
  • PHP 8.2 -- 8.4
  • Acces de administrator la panoul de administrare Magento
  • Acces SSH la server (pentru instalarea prin Composer)
  • Cont activ de comerciant Cost+
  • Magento 1.9.x sau OpenMage LTS 20+
  • PHP 7.4 sau mai nou
  • Acces de administrator la panoul de administrare Magento
  • Acces SSH sau FTP la server

1. Instalați extensia

Metoda A: Instalare prin Composer (Recomandat)

Conectați-vă la serverul Magento prin SSH și navigați la directorul rădăcină Magento.

Instalați plugin-ul:

composer require nopayn/nopayn-magento-2

Rulați comenzile de configurare Magento:

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

Dacă sunteți în modul producție, rulați și:

php bin/magento setup:static-content:deploy

Metoda B: Instalare manuală

  1. Navigați la directorul app/code
  2. Descărcați și dezarhivați versiunea Cost+ de pe GitHub
  3. Rulați comenzile de configurare:
php bin/magento setup:upgrade
php bin/magento cache:clean

Dacă sunteți în modul producție:

php bin/magento setup:static-content:deploy

Descărcați sau clonați modulul de pe GitHub.

Copiați conținutul app/ în directorul rădăcină app/ al Magento:

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

Curățați cache-ul Magento:

rm -rf var/cache/*

Conectați-vă la panoul de administrare Magento și navigați la System → Configuration → Sales → Payment Methods pentru a verifica că secțiunea NoPayn Payment Gateway apare.

Modulul creează un tabel nopayn_transactions în baza de date pentru urmărirea tranzacțiilor de plată. Acesta este creat automat la prima utilizare.

2. Configurați plugin-ul

  1. Mergeți la Stores → Configuration → Sales → Payment Methods → Cost+ Payments
  2. Introduceți cheia API (vezi pasul 3 mai jos)
  3. Activați metodele de plată pentru care aveți aprobare
  4. Salvați modificările
  1. Mergeți la System → Configuration → Sales → Payment Methods
  2. Localizați secțiunea NoPayn Payment Gateway
  3. Introduceți cheia API (vezi pasul 3 mai jos)
  4. Activați metodele de plată individuale (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
  5. Opțional, restricționați pe țară
  6. Salvați configurația

3. Introduceți credențialele API

Conectați-vă la portalul comerciantului și navigați la Site-uri web, apoi faceți clic pe site-ul web pe care doriți să îl conectați. Faceți clic pe Integrare unde veți găsi cheia API.

Portalul comerciantului Cost+ cu cheia API

Inserați cheia API în câmpul de configurare și salvați.

Activați doar metodele de plată pentru care aveți aprobare și ați primit confirmare.

Metode de plată suportate

Nume la checkoutIdentificator NoPayn
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

Fluxul de plată

  1. Clientul selectează o metodă de plată la checkout și plasează comanda
  2. Clientul este redirecționat către pagina de plată găzduită NoPayn
  3. După plată, clientul revine și statusul comenzii este actualizat automat
  4. NoPayn trimite un webhook pentru confirmarea asincronă a statusului
  1. Clientul selectează o metodă de plată la checkout și plasează comanda
  2. Comanda este creată cu statusul Pending Payment
  3. Clientul este redirecționat către pagina securizată de plată NoPayn
  4. După plată:
    • Succes — clientul revine, statusul este verificat prin API, comanda este setată la Processing
    • Anulat — clientul revine, comanda este setată la Canceled
    • Expirat (timeout de 5 minute) — webhook-ul se declanșează, comanda este setată la Canceled
  5. NoPayn trimite un webhook pentru confirmarea asincronă a statusului

Maparea statusurilor comenzii

Status NoPaynStare comandă MagentoStatus comandă Magento
newpending_paymentPending Payment
processingpending_paymentPending Payment
completedprocessingProcessing
cancelledcanceledCanceled
expiredcanceledCanceled
errorcanceledCanceled

Webhook-uri

Modulul înregistrează un endpoint webhook la /nopayn/payment/webhook. Acest URL este trimis automat la NoPayn la crearea comenzilor. Webhook-ul verifică întotdeauna statusul comenzii prin API-ul NoPayn înainte de a actualiza comanda Magento.

Nu este necesară configurarea manuală a webhook-urilor — modulul gestionează înregistrarea automat.

4. Testați configurarea

  1. Plasați câteva tranzacții de test — atât reușite, cât și eșuate
  2. Verificați că toate metodele de plată activate apar la checkout
  3. Configurați comportamentul de captură (auto-captură vs. manual) în funcție de procesul dvs. de onorare

Suport

Aveți nevoie de ajutor? Contactați echipa noastră de suport la support@costplus.io.

On this page