Cost+Docs

Drupal Commerce

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

Drupal Commerce

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

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

  • Активен търговски акаунт в Cost+
  • Drupal 10 или 11
  • Drupal Commerce 3.x
  • PHP 8.1 или по-нова версия
  • Администраторски достъп до вашия Drupal сайт

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

  • Кредитна / Дебитна карта — Visa, Mastercard и други
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay

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

Копирайте модула commerce_nopayn във вашата инсталация на Drupal и го активирайте:

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

Можете също да изтеглите модула директно от GitHub хранилището.

2. Добавяне на разплащателен шлюз

  1. Навигирайте до Commerce → Configuration → Payment gateways (/admin/commerce/config/payment-gateways)
  2. Кликнете Add payment gateway
  3. Изберете NoPayn Payment Gateway като плъгин

3. Конфигуриране на шлюза

Въведете следните настройки:

  • NoPayn API Key — Вашият търговски API ключ от портала на търговеца
  • Payment Methods — Активирайте или деактивирайте Credit Card, Apple Pay, Google Pay, Vipps MobilePay
  • Mode — Задайте на Test при използване на API ключ от sandbox уебсайт, или Live при използване на ключ от продукционен уебсайт

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

Допълнителни настройки

  • Manual Capture — Оторизирайте плащания с карти без незабавно улавяне (средствата се резервират, след което се улавят, когато поръчката бъде изпълнена)
  • Debug Logging — Активирайте, за да записвате всички API заявки и отговори в дневника на Drupal за отстраняване на грешки

Кликнете Save, когато приключите.

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

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

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

Сесиите за плащане изтичат след 5 минути по стандартите на Cost+. Модулът също изпраща детайлизирани редове на поръчката (продукти и доставка) към Cost+ за подробни записи на транзакции.

5. Конфигурация на уебхукове

URL адресът за уебхукове се генерира автоматично от Drupal Commerce:

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

Например: https://your-store.com/payment/notify/nopayn

Този URL трябва да е достъпен от интернет без удостоверяване. Модулът винаги проверява статуса на плащането чрез API — никога не се доверява само на данните от уебхука.

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

Когато ръчното улавяне е активирано за кредитни карти:

  1. Картата на клиента е оторизирана (средствата са резервирани) по време на касата
  2. Улавянето се извършва автоматично, когато поръчката премине в статус Fulfilled
  3. Ако поръчката бъде отказана, оторизацията се анулира чрез уебхук

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

Възстановявания

Възстановяванията могат да бъдат обработени директно от административния панел на Commerce. Поддържат се както пълни, така и частични възстановявания.

Таблици в базата данни

Модулът създава две таблици за проследяване:

ТаблицаПредназначение
nopayn_transactionsПроследява поръчки за плащане, създадени с API на Cost+
nopayn_refundsЗаписва операции по възстановяване за целите на одита

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

drush pmu commerce_nopayn -y
drush cr

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

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

Направете няколко тестови транзакции, за да се уверите, че всичко работи правилно. Задайте Mode на шлюза на Test и проверете както успешни, така и неуспешни плащания, преди да превключите на Live.

Поддръжка

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

On this page