Cost+Docs

OpenCart

Интегрирайте Cost+ с вашия OpenCart магазин (4.x и 3.x / ocStore 3)

OpenCart

Интегрирайте Cost+ като метод на плащане във вашия OpenCart магазин. Официалното разширение NoPayn Payment Gateway е налично за OpenCart 4 и OpenCart 3 / ocStore 3.

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

  • Активен търговски акаунт в Cost+
  • OpenCart 4.0.0.0 или по-нова версия
  • PHP 8.0 или по-нова версия
  • Администраторски достъп до таблото на OpenCart
  • Активен търговски акаунт в Cost+
  • ocStore 3.0.x или OpenCart 3.0.3.x
  • PHP 7.4 или по-нова версия
  • Администраторски достъп до таблото на OpenCart

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

  • Кредитна / Дебитна карта — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Кредитна / Дебитна карта — Visa, Mastercard, Amex, Maestro, V Pay, Bancontact, Diners, Discover
  • Apple Pay
  • Google Pay
  • Vipps / MobilePay
  • Swish

1. Инсталиране на разширението

Метод A: Качване чрез административния панел (Препоръчително)

  1. Изтеглете последната .ocmod.zip версия от GitHub
  2. В административния панел на OpenCart отидете на Extensions → Installer
  3. Качете .ocmod.zip файла
  4. Отидете на Extensions → Extensions → Payment
  5. Намерете NoPayn Payment Gateway и кликнете Install, след което Edit

Метод B: Ръчно качване

  1. Изтеглете или клонирайте хранилището
  2. Копирайте съдържанието на папката upload/ в основната директория на OpenCart
  3. Отидете на Extensions → Extensions → Payment
  4. Намерете NoPayn Payment Gateway и кликнете Install, след което Edit

Архитектура

OpenCart 3 използва настройка с множество разширения:

  • NoPayn - Global Settings — споделена конфигурация (API ключ, статуси на поръчки, наличност на методи, ръчно улавяне, логване за отстраняване на грешки)
  • NoPayn - Card Payments — плащане с кредитна/дебитна карта
  • NoPayn - Apple Pay / Google Pay — плащане с портфейл (ако е активиран само един портфейл, етикетът се коригира автоматично)
  • NoPayn - Vipps MobilePay — плащане с Vipps/MobilePay
  • NoPayn - Swish — плащане със Swish

Метод A: Качване чрез административния панел (Препоръчително)

  1. Изтеглете .ocmod.zip актива от последната GitHub версия

Използвайте .ocmod.zip актива от версията — не автоматично генерираните "Source code" изтегляния на GitHub, които съдържат оформлението на хранилището, а не инсталатора.

  1. В административния панел отидете на Extensions → Installer
  2. Качете .ocmod.zip файла
  3. Отидете на Extensions → Extensions → Payments
  4. Инсталирайте първо NoPayn - Global Settings
  5. Отворете NoPayn - Global Settings и конфигурирайте:
    • API ключ
    • Статуси на поръчки за завършени, чакащи и отказани
    • Налични методи на плащане, за които вашият търговски акаунт е одобрен
    • По желание: ръчно улавяне на карти
    • По желание: логване за отстраняване на грешки
  6. Инсталирайте модулите за каса, които искате да покажете:
    • NoPayn - Card Payments
    • NoPayn - Apple Pay / Google Pay
    • NoPayn - Vipps MobilePay
    • NoPayn - Swish
  7. За всеки модул за каса задайте: Status, Geo Zone и Sort Order

Метод B: Ръчно качване

  1. Изтеглете или клонирайте хранилището
  2. Копирайте съдържанието на папката upload/ в основната директория на магазина
  3. Отидете на Extensions → Extensions → Payments
  4. Следвайте същия ред на инсталиране като Метод A (първо Global Settings, след това модулите за каса)

2. Въвеждане на API идентификационни данни

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

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

В настройките на NoPayn Payment Gateway въведете вашия API ключ в съответното поле.

В NoPayn - Global Settings въведете вашия API ключ в съответното поле. API ключът е споделен между всички модули за каса — нужно е да го въведете само веднъж.

3. Конфигуриране на настройки за плащане

  1. Активирайте методите на плащане, за които сте одобрени
  2. Задайте предпочитаните статуси на поръчки за завършени, чакащи и отказани плащания
  3. По желание ограничете плащанията по Geo Zone
  4. Задайте Status на Enabled
  5. Кликнете Save

Глобални настройки

NoPayn - Global Settings съхранява цялата споделена конфигурация:

НастройкаОписание
API KeyВашият NoPayn API ключ
Order StatusesСъпоставяне на статуси за завършени, чакащи и отказани
Method AvailabilityКои методи на плащане са одобрени за вашия търговски акаунт
Manual CaptureОторизирайте плащания с карти — уловете по-късно
Debug LoggingАктивирайте подробно логване за отстраняване на грешки

Настройки на модулите за каса

Всеки модул за каса има собствени настройки за витрината:

НастройкаОписание
StatusАктивиране или деактивиране на този метод на плащане при касата
Geo ZoneОграничение до конкретни географски зони
Sort OrderРед на показване на страницата за плащане

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

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

  1. Клиентът избира метод на плащане Cost+ при касата
  2. Клиентът се пренасочва към хостваната страница за плащане на NoPayn
  3. След плащане клиентът се връща и статусът на поръчката се актуализира автоматично
  4. NoPayn изпраща уебхук за асинхронно потвърждение на статуса

Разширението използва хостваната страница за плащане на Cost+, което означава, че клиентите се пренасочват към сигурен формуляр за плащане. На вашия сървър не се обработват чувствителни данни от карти.

Всеки модул за каса е отделно разширение за плащане в OpenCart, което дава на клиентите различни радио опции при касата (напр. "Card Payments", "Apple Pay & Google Pay").

  1. Клиентът избира етикет на метод на плащане при касата (напр. Card Payments)
  2. Разширението създава хоствана поръчка за плащане в NoPayn
  3. Клиентът се пренасочва към защитената страница за плащане на NoPayn
  4. След плащане клиентът се връща и статусът на поръчката се актуализира автоматично
  5. NoPayn изпраща уебхук за асинхронно потвърждение на статуса

Модулът Apple Pay / Google Pay изпраща и двата метода в една транзакция, така че хостваната страница на NoPayn може да предложи и двете опции за портфейл в един поток.

Надграждане от v1.0.0 към v2.0.0

Версия 1.0.0 използваше един метод за каса наречен "NoPayn Checkout". Версия 2.0.0 преминава към отделни модули за каса за всеки метод на плащане. При надграждане:

  1. Качете новия пакет
  2. Съществуващият ви запис "NoPayn Checkout" става NoPayn - Global Settings
  3. Прегледайте и запазете глобалните настройки
  4. Инсталирайте и активирайте новите модули за каса, които искате клиентите да виждат

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

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

Поддръжка

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

On this page