Cost+Docs

nopCommerce

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

nopCommerce

Integra Cost+ bħala metodu ta' ħlas fil-ħanut nopCommerce tiegħek. Il-plugin uffiċjali NoPayn Payment Gateway jappoġġja metodi multipli ta' ħlas b'redirect dirett lejn il-metodu ta' ħlas magħżula — kompletament konformi mal-PCI DSS.

Prerekwiżiti

  • Kont attiv ta' kummerċjant Cost+
  • nopCommerce 4.90 jew aktar tard
  • .NET 9
  • Aċċess ta' amministratur għall-pannell tal-amministrazzjoni ta' nopCommerce tiegħek
  • Aċċess għall-kodiċi sors ta' nopCommerce (għall-installazzjoni tal-plugin)

Metodi ta' Ħlas Appoġġjati

Isem tal-Wiri fil-CheckoutIdentifikatur NoPayn
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

1. Installa l-Plugin

Ikkopja l-folder tal-plugin fid-direttorju sors ta' nopCommerce tiegħek:

src/Plugins/Nop.Plugin.Payments.NoPayn/

Żid il-proġett mas-soluzzjoni tiegħek u ibni:

dotnet sln add src/Plugins/Nop.Plugin.Payments.NoPayn/Nop.Plugin.Payments.NoPayn.csproj
dotnet build

Fil-pannell tal-amministrazzjoni ta' nopCommerce:

  1. Mur fuq Configuration → Local plugins
  2. Sib NoPayn Payment Gateway u ikklikkja Install
  3. Mur fuq Configuration → Payment methods
  4. Attiva NoPayn Payment Gateway
  5. Ikklikkja Configure biex tiftaħ is-settings

2. Ikkonfigura l-Plugin

Idħol fil-Portal tal-Kummerċjant u mur fuq Websites, imbagħad ikklikkja fuq il-website li trid tikkonnettja. Ikklikkja fuq Integration fejn issib iċ-ċavetta API tiegħek.

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

Fil-konfigurazzjoni tal-plugin, daħħal iċ-Ċavetta API tiegħek u aqleb il-metodi ta' ħlas li trid toffri:

SettingDeskrizzjoni
API KeyIċ-ċavetta API NoPayn tiegħek
Enable Credit / Debit CardAqleb ħlasijiet bil-karti ta' kreditu/debitu
Enable Apple PayAqleb ħlasijiet b'Apple Pay
Enable Google PayAqleb ħlasijiet b'Google Pay
Enable Vipps MobilePayAqleb ħlasijiet b'Vipps MobilePay

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 NoPayn Payment Gateway fil-checkout
  2. Selezzjoni ta' sub-metodu tidher (Credit Card, Apple Pay, eċċ.)
  3. Il-klijent jagħżel metodu u jikkonferma l-ordni
  4. L-ordni tinħoloq bl-istatus tal-ħlas Pending
  5. Il-klijent jiġi ridirezzjonat direttament lejn il-metodu ta' ħlas magħżula fuq il-paġna ta' ħlas ta' NoPayn
  6. Wara l-ħlas:
    • Suċċess — ordni mmarka bħala Paid / Processing
    • Ikkanċellata / Falluta / Skaduta — ordni ssettjata bħala Cancelled
  7. NoPayn tibgħat webhook għal konferma asinkrona tal-istatus

It-tranżazzjonijiet jiskadu wara 5 minuti. Jekk klijent ma jlestiex il-ħlas f'din it-tieqa ta' żmien, l-ordni tiġi awtomatikament ikkanċellata permezz tal-webhook.

4. Mappa tal-Istatus tal-Ordni

Status NoPaynIstatus tal-Ħlas nopCommerceIstatus tal-Ordni nopCommerce
newPendingPending
processingPendingPending
completedPaidProcessing
cancelledVoidedCancelled
expiredVoidedCancelled
errorVoidedCancelled

5. Webhooks

Il-plugin jirreġistra endpoint tal-webhook f'/NoPayn/Webhook. NoPayn tibgħat data POST li fiha l-identifikatur tal-ordni meta l-istatus tinbidel. Il-plugin jivverifika l-istatus kurrenti permezz ta' sejħa API qabel ma jaġġorna l-ordni.

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