Як інтегрувати платіжну систему на Kwiga

На платформі Kwiga є можливість налаштувати прийом оплат від учнів через інтеграції з платіжними системами. За допомогою інтеграції Ви можете приймати оплату з карток учнів, надавати розстрочки та доступ за підпискою.

Щоб налаштувати інтеграцію, перейдіть у верхньому меню до Налаштування - Інтеграції - Платіжні системи:

Вибрати зі списку назву системи, яку необхідно налаштувати.

У новому вікні заповнити налаштування та Зберегти.

На даний момент для інтеграції доступні такі платіжні системи, їх список поступово розширюється. Якщо Ви не бачите потрібну Вам платіжну систему – напишіть нам у Telegram.

plata by mono (еквайринг від monobank)

Відкрити рахунок ФОП у застосунку monobank або рахунок ТОВ в Універсал Банку, звернувшись за номером 0 800 300 200.
(Відкриття та обслуговування рахунків ФОП у Монобанку безкоштовне. Відкриття займає 2 хвилини). 

Для відкриття рахунку ФОП:
1. Відкрийте застосунок monobank
2. Свайп вниз

3. Натисніть “відкрити картку або рахунок ФОП”

4. Виберіть “рахунок ФОП”

5. Заповнити анкету та подайте заявку. Заповнити анкету-заявку на підключення. Це 2 хвилини часу. Після заповнення форми протягом доби Вам надійде повідомлення про підключення та інструкції.

Дочекатися підключення еквайрингу. Вам прийде пуш-сповіщення у застосунок monobank.

Зайти до кабінету фопа

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

*Якщо у вас немає сторінки "інтернет" – це означає:
Що Ви не залишали заявку на підключення до інтернет-еквайрингу від monobank? Залишити її можна за посиланням https://www.monobank.ua/e-comm
Или Вам ще не було відкрито доступ до отримання платежів. Будь ласка, зачекайте :)

У вікні, що відкрилося, натиснути створити токен, після чого його потрібно скопіювати

Вкажіть Псевдонім акаунта, як буде відображатися ця інтеграція на платформі Kwiga, а скопійований токен вставте в поле API Token і натисніть Зберегти.

Платіжна система 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 та Secret Key) саме для середовища Live (положення перемикача показано червоною стрілкою на скріншоті), а не для Sandbox.

Якщо ви бачите повідомлення “You're in sandbox mode”, необхідно перемкнути повзунок у режим Live.

Інтерфейс PayPal може відрізнятися залежно від країни реєстрації вашого акаунта. Альтернативне розташування перемикача показано нижче.

Також вкажіть Псевдонім акаунта — назву цієї інтеграції в Kwiga, яка буде відображатися на платформі, та натисніть “Зберегти”.

WayForPay

Натиснути на блок WayForPay і клікнути на кнопку +Акаунт.

Для налаштування інтеграції у Вас має бути обліковий запис на сайті WayForPay. Необхідно перейти на сторінку Налаштування магазину і вибрати потрібний магазин. Далі в блоці Реквізити мерчанта скопіювати дані.

Введіть значення MERCHANT LOGIN і MERCHANT SECRET KEY у відповідні поля у формі налаштувань інтеграції на Kwiga.

MERCHANTPASSWORD - не обов’язково заповнювати це поле, воно використовується лише тоді, коли ви плануєте приймати регулярні платежі (підписки) і надати клієнтам можливість самостійно скасовувати регулярні платежі у своєму кабінеті учня. Для отримання цього пароля слід звернутися до підтримки сервісу Wayforpay.

Переконайтеся, що в налаштуваннях магазину вимкнено надсилання Post на returnUrl при перенаправленні клієнта з платіжної сторінки в налаштуваннях вашого магазину в блоці Сповіщень (позначений перемикач має бути вимкнений, сірий).

LIQPAY

Натиснути на блок із назвою LiqPay, а потім на кнопку +Акаунт.

Щоб інтегрувати LiqPay з Kwiga, необхідно створити та активувати акаунт у LiqPay. Після активації компанії перейдіть на головну сторінку. Скопіюйте значення публічного і приватного ключів та вставте їх у відповідні поля форми Налаштування LiqPay, вкажіть псевдонім акаунта ( як буде називатися ця інтеграція на платформі) і натисніть Зберегти.

Stripe

Натиснути на блок із назвою Stripe, а потім на +Акаунт.

Щоб інтегрувати Stripe з Kwiga, Вам знадобиться створити та активувати акаунт у Stripe. Після створення – перейдіть у розділ «Developers» на вкладку «API keys».

Скопіюйте значення Publishable key і Secret key, а потім вставте їх у відповідні поля для налаштування інтеграції. Також вкажіть псевдонім акаунта ( як буде називатися ця інтеграція на платформі) і натисніть Зберегти.

Додавання ПДВ при оплаті через Stripe

Платіжна система Stripe дозволяє автоматично додавати ПДВ до вартості курсу. У налаштуваннях Stripe ви можете вказати список країн, для яких необхідно застосовувати податок. При переході до оплати клієнт зможе вибрати свою країну, і залежно від цього вибору Stripe або додасть ПДВ до суми, або ні.

Щоб це працювало коректно на платформі Kwiga, при налаштуванні пропозиції необхідно вимкнути опцію «ціна включає ПДВ». Це дозволить Stripe самостійно визначати місцезнаходження клієнта та, за потреби, стягувати відповідний податок.

FONDY

Натиснути на відповідний блок з логотипом Fondy і натиснути +Акаунт.

Для інтеграції необхідно бути зареєстрованим у системі Fondy. І заповнити налаштування на Kwiga:

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

ID мерчанта - сервіс Fondy присвоює Вам цей параметр, його можна знайти в акаунті Fondy, на сторінці Налаштування мерчанта → Технічні. Скопіюйте значення з поля ID мерчанта та введіть у відповідному полі в налаштуваннях на Kwiga.

Ключ платежу - зайдіть у свій акаунт у Fondy та перейдіть на сторінку Налаштування мерчанта → Технічні. Потім скопіюйте значення з поля Ключ платежу.

Дозволені валюти - вибрати валюту, у якій підключений Ваш рахунок мерчанта в Fondy, можете уточнити ці дані у саппорта.

І натиснути Зберегти.

Перевірте також, що у Вас встановлено правильний метод редиректу. Це можна зробити, зайшовши у Fondy -> Налаштування мерчанта -> Технічні > налаштування платіжної сторінки, у полі "Метод редиректу на сторінку з результатом" має бути POST (якщо стоїть інше значення - то необхідно змінити на  POST). 

Coin Payments

Для налаштування інтеграції натиснути на блок з назвою Coin Payments і потім на кнопку +Акаунт.

Для інтеграції необхідно бути зареєстрованим у CoinPayments. І заповнити налаштування на Kwiga:

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

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

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

IPN Secret - вкажіть і скопіюйте значення з поля IPN Secret на сторінці налаштування продавця https://www.coinpayments.net/acct-settings.

Ваш ID Продавця - скопіюйте значення з поля Ваш ID Продавця на сторінці базові налаштування https://www.coinpayments.net/acct-settings

Після того як усі поля заповнені, натисніть Зберегти.

У вашому акаунті Coinpayments відкрийте Налаштування продавця і в полі IPN Secret введіть https://cryptobalance.kwiga.com/coinpayment/ipn

InterKassa

Псевдонім акаунта - це назва, яку видно тільки Вам для позначення цієї платіжної системи. Вона відображається у звітах про оплату та в пропозиціях. 

Client ID можна знайти за посиланням https://portal.interkassa.com/account/checkout

Client Secret - знаходиться в полі Секретний ключ 

API Key - знаходиться в розділі API

Secret key - необхідно взяти з розділу підтвердження володіння сайтом. Вам не потрібно додавати файл із зазначеним вмістом, достатньо скопіювати вказане значення на платформу Kwiga, зберегти додавання акаунта і після цього натиснути Підтвердити на InterKassa.

Allpay

Зайдіть у свій акаунт, перейдіть у Налаштування->Інтеграція через API->Створити пару логін\/ключ.

Після цього перейдіть на платформу Kwiga, відкрийте Налаштування - Інтеграції - Платіжні системи - Allpay і натисніть додати. Заповніть необхідні поля для додавання:

Псевдонім акаунта - назва акаунта на платформі Kwiga, те, що буде виводитися у списку доданих платіжних систем. Це будь-яка зрозуміла Вам назва. 

API login - Скопіюйте те, що відображається у відповідному рядку на Allpay

API key - Скопіюйте те, що відображається у відповідному рядку на Allpay

PayU

Увійдіть у свій акаунт, відкрийте Online Payments - My shops. 

Натисніть на назву того магазину, який хочете підключити. 

Після цього перейдіть на вкладку POS і ще раз клікніть на назву магазину:

Вам завантажаться налаштування та необхідні параметри (виділені блакитним). 

Псевдонім акаунта - назва акаунта на платформі Kwiga, те, що буде виводитися у списку доданих платіжних систем. Це будь-яка зрозуміла Вам назва. 

POS ID - Скопіюйте те, що відображається у відповідному рядку  біля  POS ID (pos_id).

Second key (MD5) - Скопіюйте те, що відображається у відповідному рядку на PayU. 

Przelewy 24

Після реєстрації в системі Przelewy24 вам необхідно перейти в налаштування і створити API integration. Зверніть увагу, що для роботи та приймання оплат Вам необхідно використовувати Przelewy24 service - production version. Скористайтеся інструкцією від платіжної системи https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

Після цього перейдіть на платформу Kwiga, відкрийте Налаштування - Інтеграції - Платіжні системи - Przelewy24 і натисніть додати. Заповніть необхідні поля для додавання:

Псевдонім акаунта - назва акаунта на платформі Kwiga, яка буде відображатися у списку доданих платіжних систем. Це будь-яка зрозуміла Вам назва.

MerchantId - це Ваш логін для доступу до акаунта Przelewy24, він мав надсилатися в реєстраційному ел. листі, що підтверджує реєстрацію (confirmation e-mail after registration process). 

API key -  скопіюйте значення з поля API key (натиснувши кнопку show для відображення). 

Crc - скопіюйте значення з поля CRC key (натиснувши кнопку show для відображення). 

У платіжній системі рекомендується додати IP 159.69.103.40 до whitelist.

Klarna

Увійдіть у Ваш акаунт Klarna, відкрийте розділ Payment Settings (внизу).

Виберіть Klarna API Credentials

Натисніть +Generate new Klarna API credentials

Після цього перейдіть на платформу Kwiga, відкрийте Налаштування - Інтеграції - Платіжні системи - Kalrna і натисніть додати. Заповніть необхідні поля для додавання:

Псевдонім акаунта - назва акаунта на платформі Kwiga, яка буде відображатися у списку доданих платіжних систем. Це будь-яка зрозуміла Вам назва.

UID - скопіюйте та вставте значення, вказане в полі Username (UID) у Klarna.

Password -  скопіюйте та вставте значення, вказане в полі Password у Klarna.

RedSys

Дані для підключення Ви отримуєте в листі під час відкриття акаунта. 

Псевдонім акаунта - назва акаунта на платформі Kwiga, яка буде відображатися у списку доданих платіжних систем. Це будь-яка зрозуміла Вам назва.

DS_MERCHANT_MERCHANTCODE - номер торгового підприємства

DS_MERCHANT_TERMINAL і DS_MERCHANT_CURRENCY заповнюються так, як зазначено в листі. Якщо у Вас не зберігся лист - зверніться до служби підтримки RedSys.

Також звертаємо Вашу увагу, що спочатку акаунт RedSys відкривається в тестовому режимі, тобто Ви не зможете приймати реальні оплати. Для приймання оплат необхідно, щоб акаунт був перемкнений у режим Live в модулі адміністрування. Після цього ви отримаєте ще один лист від служби технічної підтримки BBVA з подальшими інструкціями щодо налаштування реального середовища (Production) та активації вашого віртуального TPV.