Drupal Commerce

Integrați Cost+ ca metodă de plată în magazinul dvs. Drupal Commerce. Modulul oficial NoPayn Payment Gateway folosește fluxul paginii de plată găzduite, astfel încât nicio dată de card nu atinge serverul dvs. — complet conform PCI DSS.

Cerințe preliminare

• Cont activ de comerciant Cost+
• Drupal 10 sau 11
• Drupal Commerce 3.x
• PHP 8.1 sau mai nou
• Acces de administrator la site-ul Drupal

Metode de plată suportate

• Credit / Debit Card — Visa, Mastercard și altele
• Apple Pay
• Google Pay
• Vipps / MobilePay

1. Instalați modulul

Copiați modulul commerce_nopayn în instalarea Drupal și activați-l:

cp -r commerce_nopayn /path/to/drupal/web/modules/custom/
drush en commerce_nopayn -y
drush cr

2. Adăugați un gateway de plată

1. Navigați la Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
2. Faceți clic pe Add payment gateway
3. Selectați NoPayn Payment Gateway ca plugin

3. Configurați gateway-ul

Introduceți următoarele setări:

• NoPayn API Key — Cheia API de comerciant din portalul comerciantului
• Payment Methods — Activați sau dezactivați Credit Card, Apple Pay, Google Pay, Vipps MobilePay
• Mode — Setați la Test când folosiți o cheie API de la un site web sandbox, sau Live când folosiți o cheie de site web de producție

Setări opționale

• Manual Capture — Autorizați plățile cu card de credit fără captură imediată (fondurile sunt rezervate, apoi capturate când comanda este onorată)
• Debug Logging — Activați pentru a loga toate cererile și răspunsurile API în logul Drupal pentru depanare

Faceți clic pe Save când ați terminat.

4. Fluxul de plată

Odată configurat, fluxul de plată funcționează astfel:

1. Clientul adaugă produse în coș și continuă la checkout
2. La pasul de plată, metodele Cost+ activate sunt afișate ca butoane radio
3. Clientul selectează o metodă și confirmă comanda
4. Modulul creează o comandă prin API-ul Cost+ și redirecționează către pagina de plată găzduită
5. Clientul finalizează plata pe pagina Cost+
6. Clientul revine în magazin — plata este verificată prin API
7. Un webhook de la Cost+ confirmă asincron rezultatul plății

5. Configurarea webhook-urilor

URL-ul webhook este generat automat de Drupal Commerce:

https://your-store.com/payment/notify/{gateway_machine_name}

De exemplu: https://your-store.com/payment/notify/nopayn

Acest URL trebuie să fie accesibil din internet fără autentificare. Modulul verifică întotdeauna statusul plății prin API — nu are niciodată încredere doar în payload-ul webhook-ului.

Captură manuală

Când captura manuală este activată pentru carduri de credit:

1. Cardul clientului este autorizat (fonduri rezervate) în timpul checkout-ului
2. Captura are loc automat când comanda trece la statusul Fulfilled
3. Dacă comanda este anulată, autorizarea este anulată prin webhook

Rambursări

Rambursările pot fi procesate direct din panoul de administrare Commerce. Sunt suportate atât rambursări totale, cât și parțiale.

Tabele din baza de date

Modulul creează două tabele pentru urmărire:

Dezinstalare

drush pmu commerce_nopayn -y
drush cr

Testați și lansați

Plasați câteva tranzacții de test pentru a vă asigura că totul funcționează corect. Setați Mode-ul gateway-ului la Test și verificați atât plățile reușite, cât și cele eșuate înainte de a comuta la Live.

Suport

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