Drupal Commerce

Integrējiet Cost+ ar savu Drupal Commerce veikalu, izmantojot oficiālo maksājumu vārtejas moduli

Integrējiet Cost+ kā maksājumu metodi savā Drupal Commerce veikalā. Oficiālais NoPayn Payment Gateway modulis izmanto mitinātās maksājuma lapas plūsmu, tāpēc karšu dati nepieskaras jūsu serverim — pilnībā PCI DSS sertificēts.

Priekšnosacījumi

Aktīvs Cost+ tirgotāja konts
Drupal 10 vai 11
Drupal Commerce 3.x
PHP 8.1 vai jaunāka versija
Administratora piekļuve jūsu Drupal vietnei

Atbalstītās maksājumu metodes

Credit / Debit Card — Visa, Mastercard un citas
Apple Pay
Google Pay
Vipps / MobilePay

1. Instalējiet moduli

Kopējiet commerce_nopayn moduli savā Drupal instalācijā un iespējojiet to:

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

Varat arī lejupielādēt moduli tieši no GitHub repozitorija.

2. Pievienojiet maksājumu vārteju

Dodieties uz Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
Noklikšķiniet Add payment gateway
Atlasiet NoPayn Payment Gateway kā spraudni

3. Konfigurējiet vārteju

Ievadiet šādus iestatījumus:

NoPayn API Key — jūsu tirgotāja API atslēga no tirgotāja portāla
Payment Methods — iespējojiet vai atspējojiet Credit Card, Apple Pay, Google Pay, Vipps MobilePay
Mode — iestatiet uz Test, izmantojot API atslēgu no sandbox vietnes, vai Live, izmantojot produkcijas vietnes atslēgu

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

Papildu iestatījumi

Manual Capture — autorizēt kredītkaršu maksājumus bez tūlītējas iegūšanas (līdzekļi tiek rezervēti, tad iegūti, kad pasūtījums tiek izpildīts)
Debug Logging — iespējojiet, lai reģistrētu visus API pieprasījumus un atbildes Drupal žurnālā problēmu novēršanai

Kad esat pabeidzis, noklikšķiniet Save.

4. Maksājuma plūsma

Pēc konfigurēšanas maksājuma plūsma darbojas šādi:

Klients pievieno produktus grozam un turpina norēķinus
Maksājuma solī tiek parādītas iespējotās Cost+ metodes kā radio pogas
Klients atlasa metodi un apstiprina pasūtījumu
Modulis izveido pasūtījumu caur Cost+ API un novirza uz mitināto maksājuma lapu
Klients pabeidz maksājumu Cost+ lapā
Klients atgriežas veikalā — maksājums tiek verificēts caur API
Webhook no Cost+ asinhroni apstiprina maksājuma rezultātu

Maksājuma sesijas beidzas pēc 5 minūtēm saskaņā ar Cost+ standartiem. Modulis arī nosūta detalizētas pasūtījuma rindas (produktus un piegādi) uz Cost+ precīziem darījumu ierakstiem.

5. Webhook konfigurācija

Webhook URL tiek automātiski ģenerēts Drupal Commerce:

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

Piemēram: https://your-store.com/payment/notify/nopayn

Šim URL jābūt pieejamam no interneta bez autentifikācijas. Modulis vienmēr verificē maksājuma statusu caur API — tas nekad neuzticas tikai webhook saturam.

Manuāla iegūšana

Kad manuāla iegūšana ir iespējota kredītkartēm:

Klienta karte tiek autorizēta (līdzekļi rezervēti) norēķinu laikā
Iegūšana notiek automātiski, kad pasūtījums pāriet uz Fulfilled
Ja pasūtījums tiek atcelts, autorizācija tiek anulēta caur webhook

Izmantojiet manuālu iegūšanu, ja vēlaties iekasēt no klientiem tikai tad, kad viņu pasūtījums tiek nosūtīts. Tas ir noderīgi tirgotājiem ar ilgāku izpildes laiku.

Atmaksas

Atmaksas var apstrādāt tieši no Commerce administrācijas paneļa. Tiek atbalstītas gan pilnas, gan daļējas atmaksas.

Datubāzes tabulas

Modulis izveido divas tabulas izsekošanai:

Tabula	Mērķis
`nopayn_transactions`	Izseko maksājumu pasūtījumus, kas izveidoti ar Cost+ API
`nopayn_refunds`	Reģistrē atmaksu operācijas audita nolūkiem

Atinstalēšana

drush pmu commerce_nopayn -y
drush cr

Moduļa atinstalēšana dzēsīs nopayn_transactions un nopayn_refunds tabulas. Pārliecinieties, ka eksportējat visus nepieciešamos datus pirms atinstalēšanas.

Testēšana un palaišana

Veiciet dažus testa darījumus, lai pārliecinātos, ka viss darbojas gludi. Iestatiet vārtejas Mode uz Test un verificējiet gan veiksmīgus, gan neveiksmīgus maksājumus pirms pārslēgšanas uz Live.

Atbalsts

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

On this page