Cost+Docs

Shopware

Integra Cost+ mal-ħanut Shopware 6 tiegħek bl-użu tal-plugin uffiċjali tal-ħlas

Shopware

Integra Cost+ bħala metodu ta' ħlas fil-ħanut Shopware 6 tiegħek. Il-plugin uffiċjali NoPayn Payment jappoġġja metodi multipli ta' ħlas għal kull kanal tal-bejgħ u juża l-flusso tal-Paġna ta' Ħlas Ospitata — kompletament konformi mal-PCI DSS.

Prerekwiżiti

  • Kont attiv ta' kummerċjant Cost+
  • Shopware 6.7 jew aktar tard
  • PHP 8.2 jew aktar tard
  • Aċċess SSH jew terminal għas-server Shopware tiegħek

Metodi ta' Ħlas Appoġġjati

Isem tal-CheckoutIsem TeknikuIdentifikatur NoPayn
Credit / Debit Cardnopayn_credit_cardcredit-card
Apple Paynopayn_apple_payapple-pay
Google Paynopayn_google_paygoogle-pay
Vipps MobilePaynopayn_vipps_mobilepayvipps-mobilepay

Kull metodu tista' tiġi attivata jew diżattivata għal kull kanal tal-bejgħ mill-konfigurazzjoni tal-plugin.

1. Installa l-Plugin

Ikklonja jew ikkopja l-plugin fid-direttorju custom/plugins/ ta' Shopware tiegħek:

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

Imbagħad installa u attiva permezz tas-CLI ta' Shopware:

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

2. Ikkonfigura l-Plugin

  1. Fl-admin ta' Shopware tiegħek, mur fuq Settings → Extensions → NoPayn Payment
  2. Daħħal iċ-Ċavetta API tiegħek mill-Portal tal-Kummerċjant — mur fuq Websites, ikklikkja fuq il-website li trid tikkonnettja, imbagħad ikklikkja Integration biex issib iċ-ċavetta API tiegħek
  3. Aqleb il-metodi ta' ħlas individwali on jew off
  4. Issejvja

Portal tal-Kummerċjant ta' Cost+ li juri ċ-ċavetta API

Tista' tikkonfigura ċavetta API differenti għal kull kanal tal-bejgħ jekk topera vitrini multipli.

Attiva biss il-metodi ta' ħlas li ġejt apprvat għalihom u rċevejt konferma għalihom.

3. Flusso tal-Ħlas

  1. Il-klijent jagħżel metodu ta' ħlas fil-checkout u jqiegħed l-ordni
  2. L-ordni tinħoloq bl-istatus tat-tranżazzjoni in_progress
  3. Il-klijent jiġi ridirezzjonat lejn il-Paġna ta' Ħlas Ospitata ta' NoPayn
  4. Wara l-ħlas:
    • Suċċess — il-klijent jirritorna, l-istatus tiġi vverifikata permezz tal-API, it-tranżazzjoni tissettja għal paid, l-ordni tissettja għal processing
    • Ikkanċellata — il-klijent jirritorna, it-tranżazzjoni u l-ordni jiġu ssettjati għal cancelled
    • Skaduta (timeout ta' 5 minuti) — il-webhook jintlaħaq, it-tranżazzjoni u l-ordni jiġu ssettjati għal cancelled

4. Mappa tal-Istatus tal-Ordni

Status NoPaynStat tat-TranżazzjoniStat tal-Ordni
newin_progressopen
processingin_progressopen
completedpaidin_progress
cancelledcancelledcancelled
expiredcancelledcancelled
errorcancelledcancelled

5. Webhooks

Il-plugin awtomatikament jirreġistra endpoint tal-webhook f'/api/nopayn/webhook. Din l-URL tiġi mibgħuta lil-NoPayn meta jinħolqu ordnijiet, u tipprovdi konferma asinkrona tal-istatus għat-tranżazzjonijiet kollha.

L-ebda konfigurazzjoni manwali tal-webhook mhix meħtieġa — il-plugin jittratta r-reġistrazzjoni awtomatikament.

6. Ittestja u Mur Live

Agħmel ftit tranżazzjonijiet tat-test biex tiżgura li kollox jaħdem tajjeb. Nirrakkomandaw li tittestja kemm ħlasijiet li jirnexxu u li jfallu biex tikkonferma li x-xenarji kollha huma ttrattat kif suppost.

Appoġġ

Għandek bżonn l-għajnuna? Ikkuntattja t-tim tal-appoġġ tagħna fuq support@costplus.io.

On this page