Як інтегрувати платіжну систему на 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 самостійно визначати місцезнаходження клієнта та, за потреби, нараховувати відповідний податок.

Під час оплати Stripe визначить податок на основі платіжної адреси (billing address), зазначеної покупцем, і ваших податкових налаштувань у Stripe. Якщо для країни покупця налаштовано відповідну податкову ставку, податок буде автоматично додано до вартості замовлення. Для інших країн податок може становити 0%.

Зверніть увагу: країни та податкові ставки необхідно попередньо налаштувати у вашому акаунті Stripe. Підключення Stripe до Kwiga не впливає на вже створені Stripe Payment Links — вони продовжать працювати з поточними налаштуваннями.

Докладніше про налаштування Stripe Tax: https://docs.stripe.com/tax/set-up

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.

Paddle

Paddle працює як Merchant of Record і підтримує продавців (юридичних осіб та підприємців) із більшості країн світу, включаючи країни Європейського Союзу, Україну, США, Канаду, Велику Британію, Австралію та багато інших. Перед реєстрацією рекомендується перевірити актуальний список підтримуваних країн у документації Paddle.

Для налаштування інтеграції натисніть на блок Paddle, а потім на кнопку +Акаунт.

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

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

Client-side token — скопіюйте значення Client-side token у кабінеті Paddle:

Developer Tools → Authentication → Client-side tokens.

API-ключ — скопіюйте API Key у кабінеті Paddle: Developer Tools → Authentication → API keys.

Тестовий режим — увімкніть перемикач, якщо використовуєте Sandbox-середовище Paddle. Для прийому реальних платежів залиште цей параметр вимкненим.

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

Mollie

Mollie підключає лише підприємців та компанії, зареєстровані в країнах Європейської економічної зони (EEA), а також у Великій Британії та Швейцарії. Для реєстрації необхідна юридична особа або ФОП (або аналог підприємця) у підтримуваній країні.

Для налаштування інтеграції натисніть на блок Mollie, а потім на кнопку +Акаунт. Для інтеграції необхідно мати акаунт у Mollie. Заповніть такі поля:

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

Secret key — скопіюйте Live API Key у кабінеті Mollie:  Developers → API keys.

Зберігати дані картки для наступних списань — якщо параметр увімкнений, 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. Заповніть налаштування в Kwiga:

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

API key — скопіюйте API Key у кабінеті NOWPayments:  Settings → API Keys.

IPN Secret — скопіюйте або створіть IPN Secret у розділі:  Settings → IPN settings.

Тестовий режим — увімкніть перемикач, якщо використовуєте Sandbox-режим. Для прийому реальних криптовалютних платежів залиште параметр вимкненим.

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