Cost+Docs

nopCommerce

Интегрирайте Cost+ с вашия nopCommerce магазин чрез официалния плъгин за плащане

nopCommerce

Интегрирайте Cost+ като метод на плащане във вашия nopCommerce магазин. Официалният плъгин NoPayn Payment Gateway поддържа множество методи на плащане с директно пренасочване към избрания метод на плащане — напълно PCI DSS съвместим.

Предварителни изисквания

  • Активен търговски акаунт в Cost+
  • nopCommerce 4.90 или по-нова версия
  • .NET 9
  • Администраторски достъп до административния панел на nopCommerce
  • Достъп до изходния код на nopCommerce (за инсталация на плъгина)

Поддържани методи на плащане

Име при плащанеNoPayn идентификатор
Credit / Debit Cardcredit-card
Apple Payapple-pay
Google Paygoogle-pay
Vipps MobilePayvipps-mobilepay

1. Инсталиране на плъгина

Копирайте папката на плъгина в директорията на изходния код на nopCommerce:

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

Добавете проекта към решението и компилирайте:

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

В административния панел на nopCommerce:

  1. Отидете на Configuration → Local plugins
  2. Намерете NoPayn Payment Gateway и кликнете Install
  3. Отидете на Configuration → Payment methods
  4. Активирайте NoPayn Payment Gateway
  5. Кликнете Configure, за да отворите настройките

2. Конфигуриране на плъгина

Влезте в портала на търговеца и навигирайте до Уебсайтове, след което кликнете върху уебсайта, който искате да свържете. Кликнете върху Интеграция, където ще намерите вашия API ключ.

Портал на търговеца на Cost+, показващ API ключ

В конфигурацията на плъгина въведете вашия API ключ и превключете методите на плащане, които искате да предложите:

НастройкаОписание
API KeyВашият NoPayn API ключ
Enable Credit / Debit CardПревключване на плащания с кредитни/дебитни карти
Enable Apple PayПревключване на плащания с Apple Pay
Enable Google PayПревключване на плащания с Google Pay
Enable Vipps MobilePayПревключване на плащания с Vipps MobilePay

Активирайте само методите на плащане, за които сте одобрени и сте получили потвърждение.

3. Поток на плащане

  1. Клиентът избира NoPayn Payment Gateway при касата
  2. Появява се избор на под-метод (кредитна карта, Apple Pay и др.)
  3. Клиентът избира метод и потвърждава поръчката
  4. Поръчката се създава със статус Pending
  5. Клиентът се пренасочва директно към избрания метод на плащане на страницата за плащане на NoPayn
  6. След плащане:
    • Успех — поръчката се маркира като Paid / Processing
    • Отказано / Неуспешно / Изтекло — поръчката се задава на Cancelled
  7. NoPayn изпраща уебхук за асинхронно потвърждение на статуса

Транзакциите изтичат след 5 минути. Ако клиентът не завърши плащането в този период, поръчката автоматично се отказва чрез уебхук.

4. Съпоставяне на статуси на поръчки

NoPayn статусСтатус на плащане в nopCommerceСтатус на поръчка в nopCommerce
newPendingPending
processingPendingPending
completedPaidProcessing
cancelledVoidedCancelled
expiredVoidedCancelled
errorVoidedCancelled

5. Уебхукове

Плъгинът регистрира крайна точка за уебхукове на /NoPayn/Webhook. NoPayn изпраща POST данни, съдържащи идентификатора на поръчката, при промяна на статуса. Плъгинът проверява текущия статус чрез API извикване, преди да актуализира поръчката.

Не е необходима ръчна конфигурация на уебхукове — плъгинът обработва регистрацията автоматично.

6. Тестване и пускане

Направете няколко тестови транзакции, за да се уверите, че всичко работи правилно. Препоръчваме да тествате както успешни, така и неуспешни плащания, за да потвърдите, че всички сценарии са обработени правилно.

Поддръжка

Нуждаете се от помощ? Свържете се с нашия екип за поддръжка на support@costplus.io.

On this page