How to integrate a payment system on Kwiga

Kwiga platforma 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 přijímat platby kartou od studentů, nabízet splátky a přístup na základě předplatného.

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

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

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

V současné době jsou k dispozici následující platební systémy pro integraci 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 (akceptace plateb od monobank)

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

Pro otevření účtu OSVČ:
1. Otevřete monobank aplikaci
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. Vyplňte formulář žádosti o připojení. Zabere to 2 minuty. Po vyplnění formuláře obdržíte do 24 hodin zprávu s potvrzením připojení a pokyny.

Počkejte na připojení akceptace plateb. V aplikaci monobank obdržíte push oznámení.

Přejděte do účtu OSVČ

Vyberte sekci Akceptace plateb->internet sekci

*Pokud nemáte stránku „internet“, znamená to:
Že jste nepodali žádost o připojení internetové akceptace plateb od monobank? Můžete ji podat prostřednictvím odkazu https://www.monobank.ua/e-comm
nebo vám zatím nebyl udělen přístup k přijímání plateb. Počkejte prosím :)

V okně, které se otevře, klikněte na vytvořit token a poté jej zkopírujte

Zadejte Alias účtu, pod kterým se tato integrace zobrazí 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 a poté klikněte na tlačítko +Účet a vyplňte základní nastavení:

Chcete-li připojit 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 tento odkaz:
https://developer.paypal.com/home/

Přepněte do režimu Live: přepínač se nachází v horní části nabídky. Přepínač by měl být nastaven na „Live”.

Po přepnutí účtu do režimu Live vyberte v nabídce „Apps & Credentials“:
https://developer.paypal.com/dashboard/applications/live

Vyberte (klikněte na) název aplikace nebo vytvořte novou.

Ujistěte se, že zkopírujete přihlašovací údaje (Client ID a Secret Key) pro prostředí Live (poloha přepínače je na snímku obrazovky označena červenou šipkou), nikoli pro Sandbox.

Pokud se zobrazí zpráva „You're in sandbox mode“, musíte přepnout přepínač do režimu Live.

Platební systém PayPal rozhraní se může lišit v závislosti na zemi registrace vašeho účtu. Alternativní umístění přepínače je zobrazeno níže.

Zadejte také Alias účtu — název této integrace v Kwiga, který se 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 o obchodníkovi zkopírujte údaje.

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

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 je v nastavení obchodu v bloku Oznámení vypnuto odesílání Post na return Url při přesměrování klienta ze stránky platby (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, je třeba 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 LiqPay Nastavení, zadejte alias účtu (jak se bude tato integrace na platformě nazývat) a klikněte na Uložit.

Upozornění: pokud váš Liqpay účet je kontrolován a dosud nebyl schválen pro přijímání plateb. Doporučujeme v platebním systému uvést odkaz na stránku nabídky namísto odkazu na platbu.

Stripe

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

Pro integraci Stripe s Kwiga, budete muset vytvořit a aktivovat účet Stripe . Po jeho vytvoření přejděte do sekce „Vývojáři“ a otevřete kartu “Klíče API” .

Zkopírujte hodnoty Publikovatelný klíč a tajný klíč a poté je vložte do příslušných polí pro nastavení integrace. Uveďte také alias účtu (jak se bude tato integrace na platformě nazývat) a klikněte na Uložit.

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

Platební systém Stripe umožňuje automaticky přidat DPH k ceně kurzu. V nastavení Stripe můžete určit seznam zemí, pro které má být daň uplatněna. Při přechodu k platbě si klient bude moci vybrat svou zemi a v závislosti na této volbě Stripe DPH k částce buď přidá, nebo ne.

Aby tato funkce na platformě Kwiga fungovala správně, musíte při nastavení nabídky vypnout možnost “Cena zahrnuje DPH” . To umožní systému Stripe určit polohu zákazníka a v případě potřeby účtovat příslušnou daň.

Během platby Stripe vypočítává daň na základě fakturační adresy zadané zákazníkem a vašeho daňového nastavení ve službě Stripe. Pokud je pro zemi zákazníka nastavena příslušná sazba daně, daň bude automaticky přidána k celkové hodnotě objednávky. Pro ostatní země může být daň 0 %.

Upozorňujeme, že země a daňové sazby je nutné předem nakonfigurovat ve vašem Stripe účtu. Připojení Stripe ke službě Kwiga nemá vliv na stávající platební odkazy Stripe — budou nadále fungovat s aktuálním nastavením.

Zjistěte více o nastavení Stripe Tax: https://docs.stripe.com/tax/set-up

FONDY

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

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

Alias účtu – název účtu v Kwiga, pod kterým se bude zobrazovat v seznamu účtů na platformě.

ID obchodníka – tento parametr vám přidělí služba Fondy; najdete jej ve svém účtu Fondy na stránce Nastavení obchodníka → Technické údaje. Zkopírujte hodnotu z pole ID obchodníka 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é údaje. Poté zkopírujte hodnotu z pole Platební klíč.

Povolené měny – vyberte měnu, ve které je připojen váš obchodní úč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 nastaven správný způsob přesměrování. To lze provést v sekci na Fondy -> Nastavení obchodníka -> Technické > nastavení platební stránky, v poli "Způsob přesměrování na stránku s výsledkem" by měla být nastavena hodnota POST (pokud je nastavena jiná hodnota, musí být změněna na  POST). 

Coin Payments

Chcete-li nastavit integraci, klikněte na blok s názvem Coin Payments a poté na tlačítko +Account .

Pro integraci musíte být zaregistrováni v CoinPayments. Poté vyplňte nastavení v Kwiga:

Alias účtu – název účtu na platformě Kwiga , který se zobrazí 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 ID obchodníka – zkopírujte hodnotu z pole Your ID obchodníka pole 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 Coinpayments účtu otevřete Nastavení obchodníka a zadejte https://cryptobalance.kwiga.com/coinpayment/ipn do pole IPN Secret

InterKassa

Alias účtu - jedná se o název viditelný pouze pro vás, který slouží k identifikaci tohoto platebního systému. Zobrazuje se v platebních přehledech a nabídkách. 

ID klienta najdete na odkazu

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

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

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

Tajný klíč - je nutné jej získat v sekci ověření vlastnictví webu. Nemusíte přidávat soubor s uvedeným obsahem; stačí zkopírovat uvedenou hodnotu do platformy Kwiga, uložit přidání účtu a poté kliknout na Confirm v InterKassa.

Allpay

Přihlaste se ke svému účtu a přejděte do Nastavení->Integrace API->Vytvořit dvojici přihlašovacích údajů/klíčů.

Poté přejděte na platformu Kwiga a otevřete Nastavení - Integrace - Platební systémy - Allpay a klikněte na přidat. Vyplňte požadovaná pole pro přidání:

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

API přihlašovací jméno - Zkopírujte, co je zobrazeno v příslušném řádku v Allpay

Klíč API - Zkopírujte, 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čte se nastavení a požadované parametry (zvýrazněné modře).

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

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

Druhý klíč (MD5) - Zkopírujte, co je zobrazeno v příslušném řádku v PayU. 

Przelewy 24

Po registraci v systému Przelewy24 je třeba přejít do nastavení a vytvořit integraci API. Upozorňujeme, že pro provoz a přijímání plateb je třeba používat Przelewy24 službu – produkční verzi. Použijte pokyny 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 Kwiga platformu, otevřete Settings - Integrations - Payment systems - Przelewy24 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 zobrazí v seznamu přidaných platebních systémů. Může to být jakýkoli název, který je pro vás srozumitelný.

ID obchodníka - jedná se o vaše přihlašovací jméno pro přístup k úč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 dokončení registračního procesu). 

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

CRC - zkopírujte hodnotu z pole klíče CRC (kliknutím na tlačítko Zobrazit ji zobrazíte). 

Doporučuje se přidat IP adresu 159.69.103.40 na seznam povolených v platebním systému.

Klarna

Přihlaste se ke svému účtu Klarna a otevřete sekci Nastavení plateb (dole).

Vyberte Přihlašovací údaje rozhraní Klarna API

Klikněte na +Generovat nové Klarna API přihlašovací údaje

Poté přejděte na platformu Kwiga otevřete Nastavení – Integrace – Platební systémy – Klarna 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 zobrazí v seznamu přidaných platebních systémů. Může to být libovolný název, kterému rozumíte.

UID - zkopírujte a vložte hodnotu uvedenou v poli Uživatelské jméno (UID) v Klarna.

Heslo -  zkopírujte a vložte hodnotu uvedenou v poli Heslo 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 zobrazí v seznamu přidaných platebních systémů. Může to být libovolný název, kterému rozumíte.

DS_MERCHANT_MERCHANTCODE - číslo obchodníka

DS_MERCHANT_TERMINAL a DS_MERCHANT_CURRENCY jsou vyplněny podle údajů v e-mailu. Pokud už e-mail nemáte, kontaktujte podporu RedSys.

Upozorňujeme také na skutečnost, že RedSys účet je zpočátku otevřen v testovacím režimu, což znamená, že nebudete moci přijímat skutečné platby. Chcete-li 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 BBVA technické podpory s dalšími pokyny k nastavení reálného prostředí (Production) a aktivaci vašeho virtuálního TPV.

Paddle

Paddle funguje jako Merchant of Record a podporuje prodejce (společnosti a osoby samostatně výdělečně činné) z většiny zemí světa, včetně členských států Evropské unie, Ukrajiny, Spojených států, Kanady, Spojeného království, Austrálie a mnoha dalších. Před registrací doporučujeme zkontrolovat aktuální seznam podporovaných zemí v dokumentaci Paddle.

Chcete-li nakonfigurovat integraci, klikněte na blok Paddle a poté klikněte na tlačítko + Účet .

Chcete-li integrovat Paddle, musíte mít zaregistrovaný Paddle účet. Jakmile je účet nastaven, dokončete v Kwiga následující nastavení:

Alias účtu — zadejte libovolný název integrace. Tento název se zobrazuje pouze ve vašem Kwiga účtu mezi připojenými platebními systémy.

Token na straně klienta — zkopírujte token na straně klienta z vašeho Paddle panelu:

Nástroje pro vývojáře → Ověřování → Tokeny na straně klienta.

Klíč API — zkopírujte klíč API z vašeho Paddle panel:

Nástroje pro vývojáře → Ověřování → Klíče API.

Testovací režim — tuto možnost povolte, pokud používáte prostředí Paddle Sandbox .

Nechte ji vypnutou pro přijímání ostrých plateb.

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

Mollie

Mollie podporuje pouze firmy a osoby samostatně výdělečně činné registrované v zemích Evropského hospodářského prostoru (EHP), stejně jako ve Spojeném království a Švýcarsku. Pro registraci musíte mít právnickou osobu nebo živnost (nebo rovnocennou obchodní registraci) v některé z podporovaných zemí.

Chcete-li integraci nastavit, klikněte na blok Mollie , poté klikněte na tlačítko + Účet .

K dokončení integrace musíte mít Mollie účet. Vyplňte následující pole:

Alias účtu — zadejte libovolný název integrace. Tento název se zobrazuje pouze ve vašem účtu Kwiga mezi připojenými platebními systémy.

Tajný klíč — zkopírujte živý klíč API ze svého panelu Mollie :

Vývojáři → Klíče API.

Uložit údaje o kartě pro budoucí platby — pokud je tato možnost povolena, Kwiga uloží platební token, což umožní opakované platby, aniž by zákazník musel znovu zadávat údaje o kartě (pokud vybraný způsob platby podporuje opakované platby).

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

GoPay

GoPay je určeno především pro společnosti a podnikatele ze střední Evropy. Integrace je dostupná pro právnické osoby a podnikatele z Česka, Slovenska, Polska a některých dalších zemí regionu. Úplný seznam podporovaných zemí je uveden na webových stránkách GoPay.

Chcete-li nastavit integraci, klikněte na blok GoPay a poté na tlačítko +Účet.

Pro nastavení integrace je nutné mít účet u GoPay. Vyplňte následující pole:

Alias účtu — libovolný název integrace. Zobrazuje se pouze ve vašem účtu Kwiga mezi připojenými platebními systémy.

Client ID — je k dispozici v nastavení API vašeho projektu v účtu GoPay (API → Projekt → Client ID).

Client Secret — zkopírujte tajný klíč z nastavení API vašeho projektu (API → Projekt → Client Secret).

GoID (Merchant ID) — zkopírujte identifikátor obchodníka ze svého účtu GoPay (Business Accounts → údaje o účtu → GoID).

Testovací režim — zapněte tuto možnost, pokud používáte testovací prostředí GoPay.

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

Pokud nemůžete najít Client ID nebo Client Secret, obraťte se na podporu GoPay nebo na správce svého účtu. Tyto údaje nemusí být ve standardním účtu obchodníka dostupné.

NowPayments

NOWPayments podporuje prodejce z většiny zemí světa. Vzhledem k tomu, že služba zpracovává platby v kryptoměnách, dostupnost může záviset na místních předpisech a platných sankcích. Před připojením integrace doporučujeme ověřit aktuální seznam podporovaných jurisdikcí.

Chcete-li integraci nastavit, klikněte na NowPayments blok a poté klikněte na tlačítko + Účet .

Pro integraci NOWPayments, musíte mít zaregistrovaný NOWPayments účet. V Kwiga:

Alias účtu — zadejte libovolný název integrace. Tento název se zobrazuje pouze ve vašem účtu Kwiga mezi připojenými platebními systémy.

Klíč API — zkopírujte klíč API z vašeho NOWPayments panelu:
Nastavení → Klíče API.

Tajný klíč IPN — zkopírujte nebo vygenerujte tajný klíč IPN zde:
Nastavení → Nastavení IPN.

Testovací režim — povolte tuto možnost, pokud používáte prostředí Sandbox . Pokud chcete přijímat skutečné platby v kryptoměnách, nechte ji vypnutou.

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