Как да интегрирате платежна система в Kwiga

В платформата Kwiga можете да настроите приемането на плащания от ученици чрез интеграция с платежни системи. Това позволява автоматично да приемате плащания от картите на участниците, да предлагате разсрочено плащане и да предоставяте достъп чрез абонамент.

За да настроите интеграция с платежна система, отворете настройките на профила. 

Кликнете върху аватара си в горния десен ъгъл на платформата и изберете Всички настройки. 

След това отидете в раздела Интеграции 

И отворете секцията Платежни системи.

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

След като въведете всички данни, натиснете Запази и интеграцията ще бъде активирана. След това ще можете автоматично да приемате плащания от ученици директно чрез Kwiga.

Препоръка: Преди да активирате плащанията за ученици, препоръчваме сами да тествате процеса на плащане. За тази цел можете да създадете тестова оферта с минимална цена, например 1 UAH или 1 $. Друг вариант е временно да намалите цената на реална оферта, да тествате плащането и след теста да възстановите първоначалната цена. За да протече тестът на плащането коректно, препоръчваме да го извършите в друг браузър или в режим „инкогнито“, тъй като в текущата сесия може да са запазени данни от вашия акаунт на Експерт.

В момента са достъпни интеграции с редица популярни платежни системи и този списък постоянно се разширява. Ако необходимата услуга не присъства в списъка, свържете се с нас чрез Telegram – възможно е добавянето ѝ вече да е планирано или да бъде разгледано в бъдеща актуализация.

В момента посочените платежни системи са достъпни за интеграция и списъкът им постепенно се разширява. Ако не виждате необходимата система в списъка, пишете ни в Telegram.

plata by mono (еквайринг от monobank)

Открийте сметка на едноличен търговец в приложението monobank или фирмена сметка в Universal Bank на телефон 0 800 300 200.
(Откриването и поддържането на сметки на едноличен търговец в Monobank са безплатни. Откриването отнема 2 минути). 

За да откриете сметка на едноличен търговец:
1. Отворете приложението monobank app
2. Плъзнете надолу

3. Докоснете „откриване на карта или сметка на едноличен търговец“

4. Изберете „сметка на едноличен търговец”

5. Попълнете формуляра и изпратете заявлението. Попълнете формуляра за заявка за свързване. Отнема 2 минути. След попълването на формуляра в рамките на 24 часа ще получите съобщение за потвърждение на свързването и инструкции.

Изчакайте еквайрингът да бъде свързан. Ще получите push известие в приложението monobank.

Отидете в сметката на едноличен търговец

Изберете Еквайринг->интернет раздела

*Ако нямате страница „internet“, това означава:
Че не сте подали заявка за свързване на интернет еквайринг от monobank? Можете да я подадете чрез връзката https://www.monobank.ua/e-comm
или все още не ви е предоставен достъп за получаване на плащания. Моля, изчакайте :)

В отворения прозорец щракнете върху „Създаване на токен“, след което го копирайте

Посочете Псевдоним на акаунта, чрез който тази интеграция ще се показва на Kwiga платформата, поставете копирания токен в полето API токен и щракнете върху Запазване.

Системата за плащания plata by mono позволява приемането на плащания само в три валути: EUR, USD, UAH

PayPal

Щракнете върху PayPal иконата с логото, след което щракнете върху бутона +Акаунт и попълнете основните настройки:

За да свържете PayPal към платформата, трябва да имате регистриран бизнес акаунт в paypal.com.

Влезте във вашия PayPal акаунт и следвайте тази връзка:
https://developer.paypal.com/home/

Превключете в режим Live: превключвателят се намира в горната част на менюто. Той трябва да е зададен на „Live”.

След като превключите акаунта си в режим Live, изберете „Apps & Credentials“ от менюто:
https://developer.paypal.com/dashboard/applications/live

Изберете (щракнете върху) името на приложението или създайте ново.

Уверете се, че копирате данните за достъп (Client ID and Secret Key) за средата Live (позицията на превключвателя е обозначена с червената стрелка на екранната снимка), а не за Sandbox.

Ако видите съобщението „You're in sandbox mode“, трябва да превключите на Live.

The PayPal интерфейсът може да се различава в зависимост от държавата на регистрация на вашия акаунт. По-долу е показано алтернативно разположение на превключвателя.

Посочете също Псевдоним на акаунта — името на тази интеграция в Kwiga, което ще се показва на платформата, и щракнете върху „Запазване”.

WayForPay

Щракнете върху блока WayForPay и върху бутона +Акаунт .

За да настроите интеграцията, трябва да имате акаунт на уебсайта WayForPay . Отидете на страницата Настройки на магазина и изберете необходимия магазин. След това в блока Данни за търговеца копирайте данните.

Въведете стойностите MERCHANT LOGIN и MERCHANT SECRET KEY в съответните полета във формуляра за настройки на интеграцията в Kwiga.

MERCHANTPASSWORD – това поле не е задължително. Използва се само когато планирате да приемате периодични плащания (абонаменти) и да позволявате на клиентите сами да отменят периодичните плащания в своя студентски акаунт. За да получите тази парола, свържете се с поддръжката на Wayforpay.

Уверете се, че изпращането на Post to return Url при пренасочване на клиента от страницата за плащане е деактивирано в настройките на магазина ви в блока Notifications (отбелязаният превключвател трябва да е изключен, в сиво).

LIQPAY

Щракнете върху блока с име LiqPay и след това върху бутона +Акаунт .

За да интегрирате LiqPay с Kwiga, трябва да създадете и активирате акаунт в LiqPay. След активиране на компанията отидете на главната страница. Копирайте стойностите на публичния и частния ключ и ги поставете в съответните полета на LiqPay формуляра за настройки, посочете псевдонима на акаунта (как ще се нарича тази интеграция на платформата) и щракнете върху Запазване.

Моля, имайте предвид: ако вашият Liqpay акаунтът се проверява и все още не е одобрен за приемане на плащания, препоръчваме да посочите връзката към страницата на офертата в платежната система вместо връзката за плащане.

Stripe

Щракнете върху блока с име Stripe и след това +Акаунт.

За да интегрирате Stripe с Kwiga, ще трябва да създадете и активирате Stripe акаунт. След като го създадете, отидете в секцията „Разработчици“ и отворете раздела “API ключове” .

Копирайте стойностите на Публичен ключ и Таен ключ , след което ги поставете в съответните полета за настройка на интеграцията. Посочете също псевдоним на акаунта (как ще се нарича тази интеграция в платформата) и щракнете върху Запази.

Добавяне на ДДС при плащане чрез Stripe

Платежната система Stripe ви позволява автоматично да добавяте ДДС към цената на курса. В настройките на Stripe можете да посочите списък с държави, за които трябва да се прилага данъкът. При преминаване към плащане клиентът ще може да избере своята държава и в зависимост от този избор, Stripe ще добави ДДС към сумата или не.

За да работи тази функция правилно на платформата Kwiga , трябва да деактивирате опцията “Цената включва ДДС” при настройване на офертата. Това позволява на Stripe да определи местоположението на клиента и при необходимост да начисли приложимия данък.

По време на плащането Stripe изчислява данъка въз основа на адреса за фактуриране, предоставен от клиента, и вашите данъчни настройки в Stripe. Ако за държавата на клиента е конфигурирана приложима данъчна ставка, данъкът ще бъде автоматично добавен към общата сума на поръчката. За други държави данъкът може да бъде 0%.

Моля, имайте предвид, че държавите и данъчните ставки трябва да бъдат конфигурирани предварително във вашия Stripe акаунт. Свързването на Stripe с Kwiga не засяга съществуващите Stripe Payment Links — те ще продължат да работят с текущите си настройки.

Научете повече за настройването на Stripe Tax: https://docs.stripe.com/tax/set-up

FONDY

Щракнете върху съответния блок с логото на Fondy и щракнете върху +Account.

За да интегрирате, трябва да сте регистрирани в системата Fondy . И попълнете настройките в Kwiga:

Псевдоним на акаунта - името на акаунта в Kwiga, както ще се показва в списъка с акаунти на платформата.

ID на търговеца - услугата Fondy ви присвоява този параметър; можете да го намерите във вашия акаунт във Fondy на страницата Настройки на търговеца → Техническа страница. Копирайте стойността от полето ID на търговеца и я въведете в съответното поле в настройките в Kwiga.

Ключ за плащане - отидете във вашия акаунт във Fondy и отворете Настройки на търговеца → Техническа страница. След това копирайте стойността от полето „Ключ за плащане“.

Разрешени валути - изберете валутата, в която е свързан вашият търговски акаунт във Fondy; можете да уточните тези подробности с отдела за поддръжка.

И щракнете Запазване.

Също така се уверете, че за вас е зададен правилният метод за пренасочване. Това може да се направи, като отидете в Fondy -> Настройки на търговеца -> Технически > настройки на страницата за плащане, в полето "Метод за пренасочване към страницата с резултата" трябва да бъде POST (ако е зададена друга стойност, тя трябва да бъде променена на  POST). 

Coin Payments

За да настроите интеграцията, щракнете върху блока с име Coin Payments и след това върху бутона +Акаунт .

За да извършите интеграцията, трябва да сте регистрирани в CoinPayments. И попълнете настройките в Kwiga:

Псевдоним на акаунта - името на акаунта в платформата Kwiga , което ще се показва в списъка с добавени платежни системи.

Публичен ключ - копирайте стойността от полето Public Key във вашия акаунт на страницата https://www.coinpayments.net/acct-api-keys

Частен ключ - копирайте стойността от полето Private Key във вашия акаунт на страницата https://www.coinpayments.net/acct-api-keys

IPN таен ключ - посочете и копирайте стойността от полето IPN Secret на страницата с настройките на търговеца https://www.coinpayments.net/acct-settings.

Вашият Merchant ID - копирайте стойността от Your ID на търговеца поле на страницата с основни настройки https://www.coinpayments.net/acct-settings

След като всички полета бъдат попълнени, щракнете върху Запазване.

Във вашия Coinpayments акаунт отворете Настройки на търговеца и въведете https://cryptobalance.kwiga.com/coinpayment/ipn в полето IPN Secret

InterKassa

Псевдоним на акаунта - това е името, видимо само за вас, чрез което да идентифицирате тази платежна система. То се показва в отчетите за плащания и офертите. 

ID на клиента може да бъде намерен на връзката

https://portal.interkassa.com/account/checkout

 Таен ключ на клиента - намира се в полето Secret key 

 API ключ - намира се в секцията API

Таен ключ - трябва да бъде взет от секцията за потвърждаване на собствеността върху сайта. Не е необходимо да добавяте файл с посоченото съдържание; достатъчно е да копирате посочената стойност в платформата Kwiga, да запазите добавянето на акаунта и след това да щракнете върху Confirm в InterKassa.

Allpay

Влезте в акаунта си, отидете на Settings->API Integration->Create login/key pair.

След това отидете в платформата Kwiga, отворете Settings - Integrations - Payment systems - Allpay и щракнете върху добавяне. Попълнете необходимите полета за добавяне:

Псевдоним на акаунта - името на акаунта в Kwiga платформата, което ще се показва в списъка с добавени платежни системи. Това може да бъде всяко име, което ви е ясно. 

API вход - Копирайте това, което е показано в съответния ред в Allpay

API ключ - Копирайте това, което е показано в съответния ред в Allpay

PayU

Влезте в акаунта си, отворете Онлайн плащания - Моите магазини.

Щракнете върху името на магазина, който искате да свържете.

След това отидете в раздела POS и щракнете отново върху името на магазина:

Настройките и необходимите параметри ще се заредят (отбелязани в синьо).

Псевдоним на акаунта - името на акаунта в платформата Kwiga, което ще се показва в списъка с добавените платежни системи. Това може да бъде всяко име, което ви е ясно. 

POS ID - Копирайте това, което е показано в съответния ред до POS ID (pos_id).

Втори ключ (MD5) - Копирайте това, което е показано в съответния ред в PayU. 

Przelewy 24

След регистрация в системата Przelewy24 трябва да отидете в настройките и да създадете API интеграция. Моля, имайте предвид, че за работа и приемане на плащания трябва да използвате Przelewy24 услугата - производствена версия. Използвайте инструкциите от платежната система https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

След това отидете в платформата Kwiga и отворете Настройки - Интеграции - Платежни системи - Przelewy24 и щракнете върху „Добавяне“. Попълнете необходимите полета, за да го добавите:

Псевдоним на акаунта - името на акаунта в платформата Kwiga, което ще се показва в списъка с добавените платежни системи. Може да бъде всяко име, което ви е ясно.

ID на търговеца - това е вашият вход за достъп до акаунта ви в Przelewy24; би трябвало да е изпратен в регистрационния имейл, потвърждаващ регистрацията ви (потвърждаващ имейл след процеса на регистрация). 

API ключ -  копирайте стойността от полето API ключ (като щракнете върху бутона за показване, за да я видите). 

CRC - копирайте стойността от полето за CRC ключа (като щракнете върху бутона „Покажи“, за да я видите). 

Препоръчително е да добавите IP 159.69.103.40 в белия списък в платежната система.

Klarna

Влезте във вашия Klarna акаунт и отворете секцията Настройки за плащания (в долната част).

Изберете Klarna API идентификационни данни

Щракнете върху +Генериране на нови Klarna API идентификационни данни

След това отидете в Kwiga платформата, отворете Настройки - Интеграции - Платежни системи - Klarna и щракнете върху „Добавяне“. Попълнете задължителните полета, за да го добавите:

Псевдоним на акаунта - името на акаунта в Kwiga платформата, което ще се показва в списъка с добавени платежни системи. Може да бъде всяко име, което ви е ясно.

UID - копирайте и поставете стойността, посочена в полето Потребителско име (UID) в Klarna.

Парола -  копирайте и поставете стойността, посочена в полето Парола в Klarna.

RedSys

Получавате данните за свързване в имейла при откриване на акаунта. 

Псевдоним на акаунта - името на акаунта в платформата Kwiga, което ще се показва в списъка с добавени платежни системи. Може да бъде всяко име, което ви е ясно.

DS_MERCHANT_MERCHANTCODE - номер на търговеца

DS_MERCHANT_TERMINAL и DS_MERCHANT_CURRENCY се попълват, както е посочено в имейла. Ако вече нямате имейла, свържете се с поддръжката на RedSys.

Също така обръщаме внимание на факта, че RedSys акаунтът първоначално се открива в тестов режим, което означава, че няма да можете да приемате реални плащания. За да приемате плащания, акаунтът трябва да бъде превключен в режим Live в административния модул. След това ще получите още един имейл от BBVA техническата поддръжка с допълнителни инструкции за настройване на реалната среда (Production) и активиране на вашия виртуален TPV.

Paddle

Paddle действа като Merchant of Record и поддържа продавачи (компании и еднолични търговци) от повечето държави по света, включително държавите — членки на Европейския съюз, Украйна, Съединените щати, Канада, Обединеното кралство, Австралия и много други. Преди регистрация препоръчваме да проверите актуалния списък с поддържаните държави в документацията на Paddle.

За да конфигурирате интеграцията, щракнете върху блока Paddle след това щракнете върху бутона + Акаунт .

За да интегрирате Paddle, трябва да имате регистриран Paddle акаунт. След като акаунтът ви бъде настроен, изпълнете следните настройки в Kwiga:

Псевдоним на акаунта — въведете произволно име за интеграцията. Това име се показва само във вашия Kwiga акаунт сред свързаните ви платежни системи.

Токен от клиентската страна — копирайте токена от клиентската страна от вашето Paddle табло:

Инструменти за разработчици → Удостоверяване → Токени от клиентската страна.

API ключ — копирайте API ключа от вашия Paddle табло:

Инструменти за разработчици → Удостоверяване → API ключове.

Тестов режим — активирайте тази опция, ако използвате Paddle Sandbox среда.

Оставете я деактивирана, за да приемате реални плащания.

След като попълните всички полета, щракнете върху Запазване.

Mollie

Mollie поддържа само фирми и еднолични търговци, регистрирани в държави от Европейското икономическо пространство (ЕИП), както и в Обединеното кралство и Швейцария. За да се регистрирате, трябва да имате юридическо лице или еднолично търговско дружество (или еквивалентна бизнес регистрация) в една от поддържаните държави.

За да конфигурирате интеграцията, щракнете върху блока Mollie след това щракнете върху бутона + Акаунт .

За да завършите интеграцията, трябва да имате Mollie акаунт. Попълнете следните полета:

Псевдоним на акаунта — въведете произволно име за интеграцията. Това име се показва само във вашия Kwiga акаунт сред свързаните ви платежни системи.

Таен ключ — копирайте Live API Key от вашето Mollie табло:

Разработчици → API ключове.

Запазване на данните за картата за бъдещи таксувания — когато е активирана, Kwiga съхранява платежния токен, което позволява периодични таксувания, без клиентът да трябва отново да въвежда данните за картата си (при условие че избраният метод на плащане поддържа периодични плащания).

След като попълните всички полета, щракнете върху Запазване.

GoPay

GoPay е насочен предимно към компании и предприемачи от Централна Европа. Интеграцията е достъпна за юридически лица и предприемачи от Чехия, Словакия, Полша и някои други страни от региона. Пълният списък с поддържаните държави е публикуван на уебсайта на GoPay.

За да настроите интеграцията, кликнете върху блока GoPay, а след това върху бутона +Акаунт.

За интеграцията е необходимо да имате акаунт в GoPay. Попълнете следните полета:

Псевдоним на акаунта — произволно избрано име на интеграцията. То се показва само във вашия акаунт в Kwiga сред свързаните платежни системи.

Client ID — достъпен е в API настройките на вашия проект в акаунта GoPay (API → Проект → Client ID).

Client Secret — копирайте секретния ключ от API настройките на вашия проект (API → Проект → Client Secret).

GoID (Merchant ID) — копирайте идентификатора на търговеца от вашия GoPay акаунт (Business Accounts → данни за акаунта → GoID).

Тестов режим — включете тази опция, ако използвате тестовата среда на GoPay.

След като попълните всички полета, кликнете върху Запазване.

Ако не можете да намерите Client ID или Client Secret, свържете се с поддръжката на GoPay или с администратора на вашия акаунт. Тези параметри може да не са достъпни в стандартния акаунт на търговеца.

NowPayments

NOWPayments поддържа продавачи от повечето държави по света. Тъй като услугата обработва плащания с криптовалути, наличността може да зависи от местните разпоредби и приложимите санкции. Преди да свържете интеграцията, препоръчваме да проверите актуалния списък с поддържани юрисдикции.

За да конфигурирате интеграцията, щракнете върху NowPayments блока, след което щракнете върху + Акаунт бутона.

За да интегрирате NOWPayments, трябва да имате регистриран NOWPayments акаунт. Попълнете следните настройки в Kwiga:

Псевдоним на акаунта — въведете произволно име за интеграцията. Това име се показва само във вашия Kwiga акаунт сред свързаните ви платежни системи.

API ключ — копирайте API ключа от вашето NOWPayments табло:
Настройки → API ключове.

IPN таен ключ — копирайте или генерирайте IPN тайния ключ в:
Настройки → IPN настройки.

Тестов режим — активирайте тази опция, ако използвате Sandbox средата. Оставете я деактивирана, за да приемате реални плащания с криптовалута.

След като попълните всички полета, щракнете върху Запазване.