Drupal Commerce
Интегрирайте Cost+ с вашия 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. Добавяне на разплащателен шлюз
- Навигирайте до Commerce → Configuration → Payment gateways (
/admin/commerce/config/payment-gateways) - Кликнете Add payment gateway
- Изберете 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. Поток на плащане
След конфигуриране потокът на плащане работи по следния начин:
- Клиентът добавя продукти в количката и продължава към касата
- На стъпката за плащане активираните методи на Cost+ се показват като радио бутони
- Клиентът избира метод и потвърждава поръчката
- Модулът създава поръчка чрез API на Cost+ и пренасочва към хостваната страница за плащане
- Клиентът завършва плащането на страницата на Cost+
- Клиентът се връща в магазина — плащането се проверява чрез API
- Уебхук от 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 — никога не се доверява само на данните от уебхука.
Ръчно улавяне
Когато ръчното улавяне е активирано за кредитни карти:
- Картата на клиента е оторизирана (средствата са резервирани) по време на касата
- Улавянето се извършва автоматично, когато поръчката премине в статус Fulfilled
- Ако поръчката бъде отказана, оторизацията се анулира чрез уебхук
Използвайте ръчно улавяне, ако искате да таксувате клиентите едва когато поръчката им бъде изпратена. Това е полезно за търговци с по-дълги срокове за изпълнение.
Възстановявания
Възстановяванията могат да бъдат обработени директно от административния панел на Commerce. Поддържат се както пълни, така и частични възстановявания.
Таблици в базата данни
Модулът създава две таблици за проследяване:
| Таблица | Предназначение |
|---|---|
nopayn_transactions | Проследява поръчки за плащане, създадени с API на Cost+ |
nopayn_refunds | Записва операции по възстановяване за целите на одита |
Деинсталиране
drush pmu commerce_nopayn -y
drush crДеинсталирането на модула ще изтрие таблиците nopayn_transactions и nopayn_refunds. Уверете се, че сте експортирали всички данни, от които се нуждаете, преди деинсталиране.
Тестване и пускане
Направете няколко тестови транзакции, за да се уверите, че всичко работи правилно. Задайте Mode на шлюза на Test и проверете както успешни, така и неуспешни плащания, преди да превключите на Live.
Поддръжка
Нуждаете се от помощ? Свържете се с нашия екип за поддръжка на support@costplus.io.