Cost+Docs

osCommerce

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

osCommerce

Интегрирайте Cost+ като метод на плащане във вашия osCommerce 4 магазин. Официалният модул NoPayn Payments използва потока на хостваната страница за плащане, така че данни от карти не докосват вашия сървър — напълно PCI DSS съвместим.

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

  • Активен търговски акаунт в Cost+
  • osCommerce 4.x
  • PHP 8.1 или по-нова версия
  • Активирано cURL разширение
  • SSL сертификат (HTTPS задължителен)
  • Администраторски достъп до административния панел на osCommerce

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

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

Всеки метод може да бъде индивидуално активиран или деактивиран от административния панел.

1. Инсталиране на модула

Изтеглете или клонирайте модула от GitHub.

Копирайте директорията lib/ в основната директория на osCommerce 4:

cp -r lib/ /path/to/oscommerce/

Това поставя файловете на модула на:

lib/common/modules/orderPayment/nopayn.php
lib/common/modules/orderPayment/nopayn/NoPaynApiClient.php
lib/common/modules/orderPayment/nopayn/NoPaynLogger.php
lib/common/modules/orderPayment/nopayn/NoPaynWebhookHandler.php

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

  1. Навигирайте до Modules → Payment → Online
  2. Активирайте филтрите "Show inactive" и "Show not installed", ако е необходимо
  3. Намерете NoPayn Payments и кликнете Install

2. Конфигуриране на модула

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

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

Въведете вашия API ключ и конфигурирайте следните настройки:

НастройкаОписаниеПо подразбиране
Enable NoPayn PaymentsГлавен превключвател за активиране/деактивиранеTrue
API KeyВашият NoPayn API ключ—
Enable Credit / Debit CardПоказване на кредитна/дебитна карта при касатаTrue
Enable Apple PayПоказване на Apple Pay при касатаTrue
Enable Google PayПоказване на Google Pay при касатаTrue
Enable Vipps MobilePayПоказване на Vipps MobilePay при касатаTrue
Manual Capture (Credit Card)Само оторизация — улавяне при завършване на поръчкатаFalse
Debug LoggingЗаписване на API заявки/отговори в дневникFalse
Completed Order StatusСтатус при успешно плащанеProcessing
Pending Order StatusСтатус при очакване на плащанеPending
Cancelled Order StatusСтатус при отказ/неуспех/изтичанеCancelled
Payment ZoneОграничение до географска зона (по избор)Всички зони
Sort OrderРед на показване на страницата за плащане0

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

3. Актуализиране на етикетите при касата (Препоръчително)

Етикетите по подразбиране на бутоните при касата на osCommerce предполагат еднстъпков поток. За по-добро изживяване с пренасочване към външен сайт, актуализирайте тези преводи в Admin → Localisation → Languages → English → Define:

КлючПо подразбиранеПрепоръчително
TEXT_PAY_WITH_CARDPay with cardGo to payment
TEXT_CONFIRM_AND_PAYConfirm and payReview order
CONFIRM_ORDERConfirm orderConfirm and pay

Това подобрява потребителското изживяване, като прави потока на касата по-ясен — клиентите разбират, че ще бъдат пренасочени, за да завършат плащането на защитена страница.

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

След конфигуриране потокът на плащане работи по следния начин:

  1. Клиентът избира метод на плащане Cost+ при касата
  2. Клиентът потвърждава поръчката
  3. Модулът създава чакаща поръчка и извиква API на Cost+
  4. Клиентът се пренасочва към хостваната страница за плащане на Cost+ (HPP)
  5. Клиентът завършва плащането на защитената HPP
  6. Клиентът се пренасочва обратно в магазина
  7. Модулът проверява статуса на плащането чрез API на Cost+
  8. Статусът на поръчката се актуализира съответно

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

5. Уебхукове

Модулът регистрира URL за уебхукове в Cost+ за актуализации на статуса между сървърите. Когато статусът на плащане се промени, Cost+ изпраща известие и модулът:

  1. Получава POST уебхука
  2. Проверява статуса на плащането чрез API (никога не се доверява на данните от уебхука)
  3. Актуализира статуса на поръчката в osCommerce

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

Ръчно улавяне

Когато е активирано за плащания с кредитни карти:

  • Плащането е оторизирано, но не е уловено при касата
  • Средствата се улавят, когато поръчката премине в статус completed
  • Ако поръчката бъде отказана, оторизацията автоматично се анулира

Използвайте ръчно улавяне, ако искате да таксувате клиентите едва когато поръчката им бъде изпратена. Това е полезно за търговци с по-дълги срокове за изпълнение.

Логване за отстраняване на грешки

Когато Debug Logging е активирано, модулът записва в nopayn_debug.log в директорията за логове на osCommerce. Записите в дневника включват:

  • Всички API заявки и отговори
  • Събития от уебхукове и резултати от обработка
  • Операции по улавяне и анулиране
  • Грешки (винаги се записват, независимо от настройката за отстраняване на грешки)

Всички записи имат префикс NoPayn_ за лесно филтриране.

Деинсталиране

  1. Отидете на Modules → Payment → Online в административния панел
  2. Изберете NoPayn Payments
  3. Кликнете Remove

Деинсталирането на модула премахва конфигурацията и изтрива таблиците nopayn_transactions и nopayn_refunds от базата данни. Уверете се, че сте експортирали всички данни, от които се нуждаете, преди деинсталиране.

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

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

Поддръжка

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

On this page