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

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-2Rulați comenzile de configurare Magento:
php bin/magento setup:upgrade
php bin/magento module:enable GingerPay_Payment
php bin/magento cache:cleanDacă sunteți în modul producție, rulați și:
php bin/magento setup:static-content:deployMetoda B: Instalare manuală
- Navigați la directorul
app/code - Descărcați și dezarhivați versiunea Cost+ de pe GitHub
- Rulați comenzile de configurare:
php bin/magento setup:upgrade
php bin/magento cache:cleanDacă sunteți în modul producție:
php bin/magento setup:static-content:deployDescă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
- Mergeți la Stores → Configuration → Sales → Payment Methods → Cost+ Payments
- Introduceți cheia API (vezi pasul 3 mai jos)
- Activați metodele de plată pentru care aveți aprobare
- Salvați modificările
- Mergeți la System → Configuration → Sales → Payment Methods
- Localizați secțiunea NoPayn Payment Gateway
- Introduceți cheia API (vezi pasul 3 mai jos)
- Activați metodele de plată individuale (Credit / Debit Card, Apple Pay, Google Pay, Vipps MobilePay)
- Opțional, restricționați pe țară
- 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.

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 checkout | Identificator NoPayn |
|---|---|
| Credit / Debit Card | credit-card |
| Apple Pay | apple-pay |
| Google Pay | google-pay |
| Vipps MobilePay | vipps-mobilepay |
Fluxul de plată
- Clientul selectează o metodă de plată la checkout și plasează comanda
- Clientul este redirecționat către pagina de plată găzduită NoPayn
- După plată, clientul revine și statusul comenzii este actualizat automat
- NoPayn trimite un webhook pentru confirmarea asincronă a statusului
- Clientul selectează o metodă de plată la checkout și plasează comanda
- Comanda este creată cu statusul Pending Payment
- Clientul este redirecționat către pagina securizată de plată NoPayn
- 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
- NoPayn trimite un webhook pentru confirmarea asincronă a statusului
Maparea statusurilor comenzii
| Status NoPayn | Stare comandă Magento | Status comandă Magento |
|---|---|---|
new | pending_payment | Pending Payment |
processing | pending_payment | Pending Payment |
completed | processing | Processing |
cancelled | canceled | Canceled |
expired | canceled | Canceled |
error | canceled | Canceled |
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
- Plasați câteva tranzacții de test — atât reușite, cât și eșuate
- Verificați că toate metodele de plată activate apar la checkout
- 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.