How to integrate a payment system on Kwiga

Platforma Kwiga vám umožňuje nastavit přijímání plateb od studentů prostřednictvím integrací s platebními systémy. Díky integraci můžete od studentů přijímat platby kartou, nabízet splátky a přístup na základě předplatného.

Pro nastavení integrace přejděte v horním menu do Nastavení - Integrace - Platební systémy:

Ze seznamu vyberte název systému, který potřebujete nastavit.

V novém okně vyplňte nastavení a klikněte na Uložit.

V tuto chvíli jsou pro integraci dostupné následující platební systémy a seznam se postupně rozšiřuje. Pokud nevidíte platební systém, který potřebujete, napište nám na Telegramu.

plata by mono (acquiring od monobank)

Otevřete účet OSVČ v aplikaci monobank nebo firemní účet v Universal Bank na čísle 0 800 300 200.
(Otevření a vedení účtů OSVČ v Monobank je zdarma. Otevření trvá 2 minuty). 

Pro otevření účtu OSVČ:
1. Otevřete aplikaci monobank
2. Přejeďte dolů

3. Klepněte na „otevřít kartu nebo účet OSVČ“

4. Vyberte „účet OSVČ“

5. Vyplňte formulář a odešlete žádost. Vyplnění žádosti o připojení trvá 2 minuty. Po vyplnění formuláře do 24 hodin obdržíte zprávu s potvrzením připojení a pokyny.

Počkejte na připojení acquiringu. V aplikaci monobank obdržíte push notifikaci.

Přejděte do účtu OSVČ

Vyberte sekci Acquiring->internet

*Pokud nemáte stránku "internet", znamená to toto:
Nezanechali jste žádost o připojení internet acquiringu od monobank? Můžete ji podat přes odkaz https://www.monobank.ua/e-comm
Или Ještě vám nebyl udělen přístup k přijímání plateb. Prosím, počkejte :)

V otevřeném okně klikněte na create token a poté jej zkopírujte

Zadejte Alias účtu, tedy jak se tato integrace bude zobrazovat na platformě Kwiga, vložte zkopírovaný token do pole API Token a klikněte na Uložit.

Platební systém plata by mono umožňuje přijímat platby pouze ve třech měnách: EUR, USD, UAH

PayPal

Klikněte na ikonu loga PayPal, poté klikněte na tlačítko +Účet a vyplňte základní nastavení:

Pro připojení PayPal k platformě musíte mít zaregistrovaný firemní účet na paypal.com. Přihlaste se ke svému účtu PayPal a přejděte na odkaz. Poté ve spodní části stránky najděte Connect to an e-commerce platform a klikněte na Get Started.

Pro integraci tohoto platebního systému musíte získat jedinečné identifikátory – Client ID a Secret – a zadat tyto údaje do příslušných polí nastavení v Kwiga. Ujistěte se, že kopírujete údaje (client ID a secret key) pro Live (pozice přepínače je na snímku obrazovky označena červenou šipkou), nikoli pro Sandbox. Pokud vidíte zprávu You're in sandbox mode, musíte přepnout přepínač na Live.

Také zadejte Alias účtu - název této integrace v Kwiga, tedy jak se účet bude zobrazovat na platformě, a klikněte na Uložit.

WayForPay

Klikněte na blok WayForPay a poté na tlačítko +Účet.

Pro nastavení integrace musíte mít účet na webu WayForPay. Přejděte na stránku Nastavení obchodu a vyberte požadovaný obchod. Poté v bloku Údaje obchodníka zkopírujte data.

Do příslušných polí ve formuláři nastavení integrace v Kwiga zadejte hodnoty MERCHANT LOGIN a MERCHANT SECRET KEY.

MERCHANTPASSWORD - toto pole je volitelné. Používá se pouze tehdy, když plánujete přijímat opakované platby (předplatné) a umožnit klientům, aby si opakované platby sami zrušili ve svém studentském účtu. Pro získání tohoto hesla kontaktujte podporu Wayforpay.

Ujistěte se, že v nastavení vašeho obchodu v bloku Notifications je vypnuté odesílání Post na returnUrl při přesměrování klienta z platební stránky (označený přepínač musí být vypnutý, šedý).

LIQPAY

Klikněte na blok s názvem LiqPay a poté na tlačítko +Účet.

Pro integraci LiqPay s Kwiga musíte vytvořit a aktivovat účet v LiqPay. Po aktivaci společnosti přejděte na hlavní stránku. Zkopírujte hodnoty veřejného a soukromého klíče a vložte je do příslušných polí formuláře nastavení LiqPay, zadejte alias účtu (jak se tato integrace bude na platformě jmenovat) a klikněte na Uložit.

Stripe

Klikněte na blok s názvem Stripe a poté na +Účet.

Pro integraci Stripe s Kwiga budete muset vytvořit a aktivovat účet Stripe. Po jeho vytvoření přejděte do sekce „Developers“ a otevřete kartu „API keys“.

Zkopírujte hodnoty Publishable key a Secret key, poté je vložte do příslušných polí pro nastavení integrace. Také zadejte alias účtu (jak se tato integrace bude na platformě jmenovat) a klikněte na Uložit.

Přidání DPH při platbě přes Stripe

Platební systém Stripe vám umožňuje automaticky přidat DPH k ceně kurzu. V nastavení Stripe můžete zadat seznam zemí, pro které se má daň uplatnit. Při přechodu k platbě si klient bude moci vybrat svou zemi a podle této volby Stripe buď přidá DPH k částce, nebo ne.

Aby to na platformě Kwiga fungovalo správně, musíte při nastavování nabídky vypnout možnost „cena zahrnuje DPH“. To umožní Stripe samostatně určit polohu klienta a v případě potřeby účtovat příslušnou daň.

FONDY

Klikněte na příslušný blok s logem Fondy a klikněte na +Účet.

Pro integraci musíte být zaregistrováni v systému Fondy. A vyplnit nastavení v Kwiga:

Alias účtu - název účtu v Kwiga, jak bude zobrazen v seznamu účtů na platformě.

Merchant ID - tuto hodnotu vám přidělí služba Fondy; najdete ji ve svém účtu Fondy na stránce Nastavení obchodníka → Technické. Zkopírujte hodnotu z pole Merchant ID a zadejte ji do příslušného pole v nastavení v Kwiga.

Platební klíč - přejděte do svého účtu Fondy a otevřete stránku Nastavení obchodníka → Technické. Poté zkopírujte hodnotu z pole Payment key.

Povolené měny - vyberte měnu, ve které je připojen váš obchodnický účet ve Fondy; tyto údaje si můžete upřesnit u podpory.

A klikněte na Uložit.

Také se ujistěte, že máte nastavenou správnou metodu přesměrování. To lze provést tak, že přejdete do Fondy -> Merchant settings -> Technical > payment page settings, v poli "Redirect method to the result page" by mělo být POST (pokud je nastavena jiná hodnota, je nutné ji změnit na  POST). 

Coin Payments

Pro nastavení integrace klikněte na blok s názvem Coin Payments a poté na tlačítko +Účet.

Pro integraci musíte být zaregistrováni v CoinPayments. A vyplnit nastavení v Kwiga:

Alias účtu - název účtu na platformě Kwiga, který se bude zobrazovat v seznamu přidaných platebních systémů.

Veřejný klíč - zkopírujte hodnotu z pole Public Key ve svém účtu na stránce https://www.coinpayments.net/acct-api-keys

Soukromý klíč - zkopírujte hodnotu z pole Private Key ve svém účtu na stránce https://www.coinpayments.net/acct-api-keys

IPN Secret - zadejte a zkopírujte hodnotu z pole IPN Secret na stránce nastavení obchodníka https://www.coinpayments.net/acct-settings.

Vaše Merchant ID - zkopírujte hodnotu z pole Your Merchant ID na stránce základního nastavení https://www.coinpayments.net/acct-settings

Po vyplnění všech polí klikněte na Uložit.

Ve svém účtu Coinpayments otevřete Merchant Settings a do pole IPN Secret zadejte https://cryptobalance.kwiga.com/coinpayment/ipn

InterKassa

Alias účtu - toto je název viditelný pouze pro vás pro identifikaci tohoto platebního systému. Zobrazuje se v platebních přehledech a nabídkách. 

Client ID najdete na odkazu https://portal.interkassa.com/account/checkout

Client Secret - nachází se v poli Secret key 

API klíč - se nachází v sekci API

Secret key - je třeba vzít ze sekce ověření vlastnictví webu. Není nutné přidávat soubor s uvedeným obsahem; stačí zkopírovat uvedenou hodnotu na platformu Kwiga, uložit přidání účtu a poté kliknout na Confirm v InterKassa.

Allpay

Přihlaste se ke svému účtu, přejděte do Settings->API Integration->Create login\/key pair.

Poté přejděte na platformu Kwiga, otevřete Settings - Integrations - Payment systems - Allpay a klikněte na přidat. Vyplňte požadovaná pole pro přidání:

Alias účtu - název účtu na platformě Kwiga, který se bude zobrazovat v seznamu přidaných platebních systémů. Může to být jakýkoli název, který je vám srozumitelný. 

API login - Zkopírujte to, co je zobrazeno v příslušném řádku v Allpay

API key - Zkopírujte to, co je zobrazeno v příslušném řádku v Allpay

PayU

Přihlaste se ke svému účtu, otevřete Online Payments - My shops. 

Klikněte na název obchodu, který chcete připojit. 

Poté přejděte na kartu POS a znovu klikněte na název obchodu:

Načtou se vám nastavení a požadované parametry (zvýrazněné modře). 

Alias účtu - název účtu na platformě Kwiga, který se bude zobrazovat v seznamu přidaných platebních systémů. Může to být jakýkoli název, který je vám srozumitelný. 

POS ID - Zkopírujte to, co je zobrazeno v příslušném řádku vedle POS ID (pos_id).

Second key (MD5) - Zkopírujte to, co je zobrazeno v příslušném řádku v PayU. 

Przelewy 24

Po registraci v systému Przelewy24 musíte přejít do nastavení a vytvořit integraci API. Upozorňujeme, že pro provoz a přijímání plateb je nutné použít službu Przelewy24 - produkční verzi. Použijte pokyny z platebního systému https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

Poté přejděte na platformu Kwiga, otevřete Nastavení - Integrace - Platební systémy - Przelewy24 a klikněte na přidat. Pro přidání vyplňte povinná pole:

Alias účtu - název účtu na platformě Kwiga, který se bude zobrazovat v seznamu přidaných platebních systémů. Může to být jakýkoli název, který je vám srozumitelný.

MerchantId - toto je vaše přihlašovací jméno pro přístup k vašemu účtu Przelewy24; mělo vám být zasláno v registračním e-mailu potvrzujícím vaši registraci (potvrzovací e-mail po procesu registrace). 

Klíč API -  zkopírujte hodnotu z pole API key (kliknutím na tlačítko show ji zobrazíte). 

Crc - zkopírujte hodnotu z pole CRC key (kliknutím na tlačítko show ji zobrazíte). 

Doporučuje se přidat IP 159.69.103.40 na whitelist v platebním systému.

Klarna

Přihlaste se do svého účtu Klarna a otevřete sekci Payment Settings (dole).

Vyberte Klarna API Credentials

Klikněte na +Generate new Klarna API credentials

Poté přejděte na platformu Kwiga, otevřete Nastavení - Integrace - Platební systémy - Kalrna a klikněte na přidat. Pro přidání vyplňte povinná pole:

Alias účtu - název účtu na platformě Kwiga, který se bude zobrazovat v seznamu přidaných platebních systémů. Může to být jakýkoli název, který je vám srozumitelný.

UID - zkopírujte a vložte hodnotu uvedenou v poli Username (UID) v Klarna.

Heslo -  zkopírujte a vložte hodnotu uvedenou v poli Password v Klarna.

RedSys

Údaje pro připojení obdržíte e-mailem při otevření účtu. 

Alias účtu - název účtu na platformě Kwiga, který se bude zobrazovat v seznamu přidaných platebních systémů. Může to být jakýkoli název, který je vám srozumitelný.

DS_MERCHANT_MERCHANTCODE - číslo obchodníka

DS_MERCHANT_TERMINAL a DS_MERCHANT_CURRENCY se vyplňují podle údajů uvedených v e-mailu. Pokud už e-mail nemáte, kontaktujte podporu RedSys.

Rádi bychom také upozornili na skutečnost, že účet RedSys je zpočátku otevřen v testovacím režimu, což znamená, že nebudete moci přijímat skutečné platby. Abyste mohli přijímat platby, musí být účet v administračním modulu přepnut do režimu Live. Poté obdržíte další e-mail od technické podpory BBVA s dalšími pokyny pro nastavení reálného prostředí (Production) a aktivaci vašeho virtuálního TPV.