Cost+Docs

Shopware

Integrați Cost+ cu magazinul dvs. Shopware 6 folosind plugin-ul oficial de plată

Shopware

Integrați Cost+ ca metodă de plată în magazinul dvs. Shopware 6. Plugin-ul oficial NoPayn Payment suportă mai multe metode de plată per canal de vânzare și folosește fluxul paginii de plată găzduite — complet conform PCI DSS.

Cerințe preliminare

  • Cont activ de comerciant Cost+
  • Shopware 6.7 sau mai nou
  • PHP 8.2 sau mai nou
  • Acces SSH sau terminal la serverul Shopware

Metode de plată suportate

Nume la checkoutNume tehnicIdentificator NoPayn
Credit / Debit Cardnopayn_credit_cardcredit-card
Apple Paynopayn_apple_payapple-pay
Google Paynopayn_google_paygoogle-pay
Vipps MobilePaynopayn_vipps_mobilepayvipps-mobilepay

Fiecare metodă poate fi activată sau dezactivată per canal de vânzare din configurarea plugin-ului.

1. Instalați plugin-ul

Clonați sau copiați plugin-ul în directorul custom/plugins/ al Shopware:

cd /path/to/shopware/custom/plugins
git clone git@github.com:NoPayn/shopware.git NoPaynPayment

Apoi instalați și activați prin CLI-ul Shopware:

bin/console plugin:refresh
bin/console plugin:install NoPaynPayment --activate
bin/console cache:clear

2. Configurați plugin-ul

  1. În panoul de administrare Shopware, mergeți la Settings → Extensions → NoPayn Payment
  2. Introduceți cheia API din portalul comerciantului — navigați la Site-uri web, faceți clic pe site-ul web pe care doriți să îl conectați, apoi faceți clic pe Integrare pentru a găsi cheia API
  3. Comutați metodele de plată individuale activat sau dezactivat
  4. Salvați

Portalul comerciantului Cost+ cu cheia API

Puteți configura o cheie API diferită per canal de vânzare dacă operați mai multe vitrine.

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

3. Fluxul de plată

  1. Clientul selectează o metodă de plată la checkout și plasează comanda
  2. Comanda este creată cu statusul tranzacției in_progress
  3. Clientul este redirecționat către pagina de plată găzduită NoPayn
  4. După plată:
    • Succes — clientul revine, statusul este verificat prin API, tranzacția setată la paid, comanda setată la processing
    • Anulat — clientul revine, tranzacția și comanda setate la cancelled
    • Expirat (timeout de 5 minute) — webhook-ul se declanșează, tranzacția și comanda setate la cancelled

4. Maparea statusurilor comenzii

Status NoPaynStare tranzacțieStare comandă
newin_progressopen
processingin_progressopen
completedpaidin_progress
cancelledcancelledcancelled
expiredcancelledcancelled
errorcancelledcancelled

5. Webhook-uri

Plugin-ul înregistrează automat un endpoint webhook la /api/nopayn/webhook. Acest URL este trimis la NoPayn la crearea comenzilor, oferind confirmare asincronă a statusului pentru toate tranzacțiile.

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

6. Testați și lansați

Plasați câteva tranzacții de test pentru a vă asigura că totul funcționează corect. Vă recomandăm să testați atât plăți reușite, cât și eșuate pentru a confirma că toate scenariile sunt gestionate corect.

Suport

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

On this page