Jak zintegrować system płatności na Kwiga

Kwiga platforma umożliwia skonfigurowanie przyjmowania płatności od kursantów za pośrednictwem integracji z systemami płatności. Dzięki integracji możesz przyjmować płatności kartą od kursantów, oferować płatności ratalne i dostęp oparty na subskrypcji.

Aby skonfigurować integrację, przejdź do górnego menu Ustawienia - Integracje - Systemy płatności:

Wybierz z listy nazwę systemu, który chcesz skonfigurować.

W nowym oknie uzupełnij ustawienia i Zapisz.

Obecnie do integracji dostępne są następujące systemy płatności, a lista jest stopniowo rozszerzana. Jeśli nie widzisz systemu płatności, którego potrzebujesz, napisz do nas na Telegramie.

plata by mono (acquiring od monobank)

Otwórz konto jednoosobowej działalności gospodarczej w aplikacji monobank lub konto firmowe w Universal Bank dzwoniąc pod numer 0 800 300 200.
(Otwarcie i prowadzenie konta jednoosobowej działalności gospodarczej w Monobank jest bezpłatne. Otwarcie zajmuje 2 minuty). 

Aby otworzyć konto jednoosobowej działalności gospodarczej:
1. Otwórz aplikację monobank aplikację
2. Przesuń w dół

3. Dotknij „otwórz kartę lub konto jednoosobowej działalności gospodarczej”

4. Wybierz „konto jednoosobowej działalności gospodarczej”

5. Wypełnij formularz i wyślij wniosek. Wypełnij formularz zgłoszeniowy dotyczący podłączenia. Zajmie to 2 minuty. Po wypełnieniu formularza w ciągu 24 godzin otrzymasz wiadomość z potwierdzeniem podłączenia i instrukcjami.

Poczekaj na podłączenie acquiringu. Otrzymasz powiadomienie push w aplikacji monobank.

Przejdź do konta jednoosobowej działalności gospodarczej

Wybierz Acquiring->internet sekcję

*Jeśli nie masz strony „internet”, oznacza to:
Nie złożyłeś wniosku o podłączenie internet acquiringu od monobank? Możesz go złożyć za pomocą linku https://www.monobank.ua/e-comm
lub Nie przyznano Ci jeszcze dostępu do otrzymywania płatności. Prosimy poczekać :)

W otwartym oknie kliknij utwórz token, a następnie skopiuj go

Określ Alias konta, czyli nazwę, pod którą ta integracja będzie wyświetlana na Kwiga platformie, wklej skopiowany token w polu Token API i kliknij Zapisz.

System płatności plata by mono umożliwia przyjmowanie płatności tylko w trzech walutach: EUR, USD, UAH

PayPal

Kliknij ikonę logo PayPal , a następnie kliknij przycisk +Konto i wypełnij podstawowe ustawienia:

Aby połączyć PayPal z platformą, musisz mieć zarejestrowane konto firmowe na paypal.com.

Zaloguj się na swoje konto PayPal i przejdź pod ten link:
https://developer.paypal.com/home/

Przełącz na tryb Live: przełącznik znajduje się u góry menu. Powinien być ustawiony na „Live”.

Po przełączeniu konta na tryb Live wybierz z menu „Apps & Credentials”:
https://developer.paypal.com/dashboard/applications/live

Wybierz (kliknij) nazwę aplikacji lub utwórz nową.

Upewnij się, że kopiujesz dane uwierzytelniające (Client ID and Secret Key) dla środowiska Live (pozycja przełącznika jest wskazana czerwoną strzałką na zrzucie ekranu), a nie dla Sandbox.

Jeśli widzisz komunikat „You're in sandbox mode”, musisz przełączyć przełącznik na Live.

System PayPal interfejs może się różnić w zależności od kraju rejestracji konta. Poniżej przedstawiono alternatywne umiejscowienie przełącznika.

Podaj również Alias konta — nazwę tej integracji w Kwiga, która będzie wyświetlana na platformie, a następnie kliknij „Zapisz”.

WayForPay

Kliknij blok WayForPay, a następnie kliknij przycisk +Konto .

Aby skonfigurować integrację, musisz mieć konto na stronie WayForPay . Przejdź na stronę Ustawienia sklepu i wybierz wymagany sklep. Następnie w sekcji Dane sprzedawcy skopiuj dane.

Wprowadź wartości MERCHANT LOGIN i MERCHANT SECRET KEY w odpowiednich polach formularza ustawień integracji w Kwiga.

MERCHANTPASSWORD - to pole jest opcjonalne. Jest używane tylko wtedy, gdy planujesz przyjmować płatności cykliczne (subskrypcje) i umożliwić klientom samodzielne anulowanie płatności cyklicznych na ich koncie kursanta. Aby uzyskać to hasło, skontaktuj się z pomocą techniczną Wayforpay.

Upewnij się, że opcja sending Post to return Url podczas przekierowywania klienta ze strony płatności jest wyłączona w ustawieniach sklepu w sekcji Notifications (zaznaczony przełącznik musi być wyłączony, szary).

LIQPAY

Kliknij blok o nazwie LiqPay a następnie przycisk +Konto .

Aby zintegrować LiqPay z Kwiga, musisz utworzyć i aktywować konto w LiqPay. Po aktywowaniu firmy przejdź na stronę główną. Skopiuj wartości klucza publicznego i prywatnego oraz wklej je w odpowiednich polach formularza LiqPay Ustawienia, podaj alias konta (nazwę, pod którą ta integracja będzie widoczna na platformie), a następnie kliknij Zapisz.

Uwaga: jeśli Twoje Liqpay konto jest w trakcie weryfikacji i nie zostało jeszcze zatwierdzone do przyjmowania płatności, zalecamy podanie w systemie płatności linku do strony oferty zamiast linku do płatności.

Stripe

Kliknij blok o nazwie Stripe a następnie +Konto.

Aby zintegrować Stripe z Kwiga, musisz utworzyć i aktywować konto Stripe . Po jego utworzeniu przejdź do sekcji „Programiści” i otwórz kartę “Klucze API” .

Skopiuj wartości Klucz publiczny i Klucz tajny , a następnie wklej je w odpowiednie pola konfiguracji integracji. Podaj również alias konta (nazwę, pod jaką ta integracja będzie widoczna na platformie) i kliknij Zapisz.

Dodawanie VAT przy płatności przez Stripe

System płatności Stripe umożliwia automatyczne dodawanie VAT do ceny kursu. W ustawieniach Stripe możesz określić listę krajów, dla których podatek ma być naliczany. Podczas przechodzenia do płatności klient będzie mógł wybrać swój kraj, a w zależności od tego wyboru Stripe doda VAT do kwoty lub nie.

Aby ta funkcja działała poprawnie na platformie Kwiga , podczas konfiguracji oferty musisz wyłączyć opcję “Cena zawiera VAT” . Pozwala to Stripe określić lokalizację klienta i w razie potrzeby naliczyć odpowiedni podatek.

Podczas płatności Stripe oblicza podatek na podstawie adresu rozliczeniowego podanego przez klienta oraz Twoich ustawień podatkowych w Stripe. Jeśli dla kraju klienta skonfigurowano odpowiednią stawkę podatku, podatek zostanie automatycznie dodany do łącznej kwoty zamówienia. Dla innych krajów podatek może wynosić 0%.

Pamiętaj, że kraje i stawki podatkowe muszą zostać wcześniej skonfigurowane na Twoim koncie Stripe Połączenie Stripe z Kwiga nie wpływa na istniejące linki płatnicze Stripe — będą nadal działać z obecnymi ustawieniami.

Dowiedz się więcej o konfiguracji Stripe Tax: https://docs.stripe.com/tax/set-up

FONDY

Kliknij odpowiedni blok z logo Fondy i kliknij +Konto.

Aby przeprowadzić integrację, musisz być zarejestrowany w systemie Fondy . Następnie uzupełnij ustawienia w Kwiga:

Alias konta - nazwa konta w Kwiga, pod którą będzie wyświetlane na liście kont na platformie.

Identyfikator sprzedawcy - usługa Fondy przypisuje Ci ten parametr; znajdziesz go na swoim koncie Fondy na stronie Ustawienia sprzedawcy → Techniczne stronie. Skopiuj wartość z pola Identyfikator sprzedawcy i wprowadź ją w odpowiednim polu ustawień w Kwiga.

Klucz płatności - przejdź do swojego konta Fondy i otwórz Ustawienia sprzedawcy → Techniczne stronę. Następnie skopiuj wartość z pola Klucz płatności.

Dozwolone waluty - wybierz walutę, w której podłączone jest Twoje konto sprzedawcy w Fondy; możesz doprecyzować te informacje z pomocą techniczną.

Następnie kliknij Zapisz.

Upewnij się również, że ustawiono właściwą metodę przekierowania. Można to zrobić, przechodząc do Fondy -> Merchant settings -> Technical > payment page settings, w polu "Redirect method to the result page" powinna być ustawiona wartość POST (jeśli ustawiona jest inna wartość, należy ją zmienić na  POST). 

Coin Payments

Aby skonfigurować integrację, kliknij blok o nazwie Coin Payments a następnie przycisk +Account .

Aby zintegrować, musisz być zarejestrowany w CoinPayments. Następnie wypełnij ustawienia w Kwiga:

Alias konta - nazwa konta na platformie Kwiga , która będzie wyświetlana na liście dodanych systemów płatności.

Klucz publiczny - skopiuj wartość z pola Public Key na stronie konta https://www.coinpayments.net/acct-api-keys

Klucz prywatny - skopiuj wartość z pola Private Key na stronie konta https://www.coinpayments.net/acct-api-keys

Sekret IPN - podaj i skopiuj wartość z pola IPN Secret na stronie ustawień sprzedawcy https://www.coinpayments.net/acct-settings.

Twój identyfikator sprzedawcy - skopiuj wartość z pola Your ID sprzedawcy pole na stronie podstawowych ustawień https://www.coinpayments.net/acct-settings

Po wypełnieniu wszystkich pól kliknij Zapisz.

Na swoim Coinpayments koncie otwórz Ustawienia sprzedawcy i wprowadź https://cryptobalance.kwiga.com/coinpayment/ipn w polu Sekret IPN

InterKassa

Alias konta - to nazwa widoczna tylko dla Ciebie, służąca do identyfikacji tego systemu płatności. Jest wyświetlana w raportach płatności i ofertach. 

ID klienta można znaleźć pod linkiem

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

 Sekret klienta - znajduje się w polu Klucz tajny 

 Klucz API - znajduje się w sekcji API

Klucz tajny - należy pobrać z sekcji weryfikacji własności witryny. Nie musisz dodawać pliku o określonej zawartości; wystarczy skopiować wskazaną wartość na platformę Kwiga, zapisać dodanie konta, a następnie kliknąć Potwierdź w InterKassa.

Allpay

Zaloguj się na swoje konto, przejdź do Ustawienia->Integracja API->Utwórz parę loginu/klucza.

Następnie przejdź na platformę Kwiga, otwórz Ustawienia - Integracje - Systemy płatności - Allpay i kliknij dodaj. Wypełnij wymagane pola, aby dodać:

Alias konta - nazwa konta na Kwiga platformie, która będzie wyświetlana na liście dodanych systemów płatności. Może to być dowolna, zrozumiała dla Ciebie nazwa. 

Login API - Skopiuj to, co jest wyświetlane w odpowiednim wierszu w Allpay

Klucz API - Skopiuj to, co jest wyświetlane w odpowiednim wierszu w Allpay

PayU

Zaloguj się na swoje konto, otwórz Płatności online - Moje sklepy.

Kliknij nazwę sklepu, który chcesz połączyć.

Następnie przejdź do zakładki POS i kliknij nazwę sklepu ponownie:

Ustawienia i wymagane parametry zostaną załadowane (wyróżnione na niebiesko).

Alias konta - nazwa konta na platformie Kwiga, która będzie wyświetlana na liście dodanych systemów płatności. Może to być dowolna, zrozumiała dla Ciebie nazwa. 

ID POS - Skopiuj to, co jest wyświetlane w odpowiednim wierszu obok ID POS (pos_id).

Drugi klucz (MD5) - Skopiuj to, co jest wyświetlane w odpowiednim wierszu w PayU. 

Przelewy 24

Po rejestracji w systemie Przelewy24 musisz przejść do ustawień i utworzyć integrację API. Pamiętaj, że aby działać i przyjmować płatności, musisz korzystać z Przelewy24 usługi - wersji produkcyjnej. Skorzystaj z instrukcji systemu płatności https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

Następnie przejdź do Kwiga platformy, otwórz Ustawienia - Integracje - Systemy płatności - Przelewy24 i kliknij „dodaj”. Wypełnij wymagane pola, aby go dodać:

Alias konta - nazwa konta na platformie Kwiga, która będzie wyświetlana na liście dodanych systemów płatności. Może to być dowolna, zrozumiała dla Ciebie nazwa.

ID sprzedawcy - jest to Twój login umożliwiający dostęp do konta Przelewy24; powinien zostać wysłany w wiadomości e-mail rejestracyjnej potwierdzającej rejestrację (wiadomość e-mail z potwierdzeniem po procesie rejestracji). 

Klucz API -  skopiuj wartość z pola klucza API (klikając przycisk „pokaż”, aby go wyświetlić). 

CRC - skopiuj wartość z pola klucza CRC (klikając przycisk pokaż, aby ją wyświetlić). 

Zaleca się dodać adres IP 159.69.103.40 do białej listy w systemie płatności.

Klarna

Zaloguj się na swoje konto Klarna i otwórz sekcję Ustawienia płatności (na dole).

Wybierz Dane uwierzytelniające API Klarna

Kliknij +Wygeneruj nowe API Klarna dane uwierzytelniające

Następnie przejdź do Kwiga platformy, otwórz Ustawienia - Integracje - Systemy płatności - Klarna i kliknij dodaj. Wypełnij wymagane pola, aby je dodać:

Alias konta - nazwa konta na platformie Kwiga która będzie wyświetlana na liście dodanych systemów płatności. Może to być dowolna nazwa, która jest dla Ciebie zrozumiała.

UID - skopiuj i wklej wartość podaną w polu Nazwa użytkownika (UID) w Klarna.

Hasło -  skopiuj i wklej wartość podaną w polu Hasło w Klarna.

RedSys

Dane połączenia otrzymasz w wiadomości e-mail podczas otwierania konta. 

Alias konta - nazwa konta na platformie Kwiga, która będzie wyświetlana na liście dodanych systemów płatności. Może to być dowolna nazwa, która jest dla Ciebie zrozumiała.

DS_MERCHANT_MERCHANTCODE - numer sprzedawcy

DS_MERCHANT_TERMINAL i DS_MERCHANT_CURRENCY są wypełnione zgodnie z informacjami podanymi w e-mailu. Jeśli nie masz już tego e-maila, skontaktuj się z pomocą techniczną RedSys.

Zwracamy również uwagę na fakt, że konto RedSys jest początkowo otwierane w trybie testowym, co oznacza, że nie będzie można przyjmować rzeczywistych płatności. Aby przyjmować płatności, konto musi zostać przełączone w tryb Live w module administracyjnym. Następnie otrzymasz kolejny e-mail od BBVA pomocy technicznej z dalszymi instrukcjami dotyczącymi konfiguracji rzeczywistego środowiska (Production) i aktywacji wirtualnego TPV.

Paddle

Paddle działa jako Merchant of Record i obsługuje sprzedawców (firmy i osoby prowadzące jednoosobową działalność gospodarczą) z większości krajów na świecie, w tym z państw członkowskich Unii Europejskiej, Ukrainy, Stanów Zjednoczonych, Kanady, Wielkiej Brytanii, Australii i wielu innych. Przed rejestracją zalecamy sprawdzenie aktualnej listy obsługiwanych krajów w dokumentacji Paddle.

Aby skonfigurować integrację, kliknij blok Paddle a następnie kliknij przycisk + Konto .

Aby zintegrować Paddle, musisz mieć zarejestrowane konto Paddle . Po skonfigurowaniu konta wykonaj następujące ustawienia w Kwiga:

Alias konta — wpisz dowolną nazwę integracji. Ta nazwa jest wyświetlana tylko na Twoim koncie Kwiga wśród podłączonych systemów płatności.

Token po stronie klienta — skopiuj token po stronie klienta z panelu Paddle :

Narzędzia programistyczne → Uwierzytelnianie → Tokeny po stronie klienta.

Klucz API — skopiuj klucz API z Twojego Paddle panel:

Narzędzia programistyczne → Uwierzytelnianie → Klucze API.

Tryb testowy — włącz tę opcję, jeśli używasz środowiska Paddle Sandbox .

Pozostaw ją wyłączoną, aby akceptować płatności na żywo.

Po wypełnieniu wszystkich pól kliknij Zapisz.

Mollie

Mollie obsługuje wyłącznie firmy i jednoosobowe działalności gospodarcze zarejestrowane w krajach Europejskiego Obszaru Gospodarczego (EOG), a także w Wielkiej Brytanii i Szwajcarii. Aby się zarejestrować, musisz posiadać osobę prawną lub jednoosobową działalność gospodarczą (albo równoważną rejestrację firmy) w jednym z obsługiwanych krajów.

Aby skonfigurować integrację, kliknij blok Mollie a następnie kliknij przycisk + Konto .

Aby ukończyć integrację, musisz mieć konto Mollie . Wypełnij następujące pola:

Alias konta — wprowadź dowolną nazwę integracji. Ta nazwa jest wyświetlana tylko na Twoim koncie Kwiga wśród połączonych systemów płatności.

Klucz tajny — skopiuj Klucz API na żywo z panelu Mollie :

Programiści → Klucze API.

Zapisuj dane karty na potrzeby przyszłych obciążeń — po włączeniu Kwiga zapisuje token płatności, umożliwiając cykliczne obciążenia bez konieczności ponownego wprowadzania przez klienta danych karty (pod warunkiem że wybrana metoda płatności obsługuje płatności cykliczne).

Po wypełnieniu wszystkich pól kliknij Zapisz.

GoPay

GoPay jest przeznaczony przede wszystkim dla firm i przedsiębiorców z Europy Środkowej. Integracja jest dostępna dla osób prawnych i przedsiębiorców z Czech, Słowacji, Polski oraz niektórych innych krajów regionu. Pełna lista obsługiwanych krajów znajduje się na stronie GoPay.

Aby skonfigurować integrację, kliknij blok GoPay, a następnie przycisk +Konto.

Do skonfigurowania integracji wymagane jest konto w GoPay. Wypełnij następujące pola:

Alias konta — dowolna nazwa integracji. Jest ona wyświetlana wyłącznie na Twoim koncie Kwiga wśród podłączonych systemów płatności.

Client ID — jest dostępny w ustawieniach API Twojego projektu na koncie GoPay (API → Projekt → Client ID).

Client Secret — skopiuj tajny klucz z ustawień API swojego projektu (API → Projekt → Client Secret).

GoID (Merchant ID) — skopiuj identyfikator sprzedawcy ze swojego konta GoPay (Business Accounts → szczegóły konta → GoID).

Tryb testowy — włącz tę opcję, jeśli korzystasz ze środowiska testowego GoPay.

Po wypełnieniu wszystkich pól kliknij Zapisz.

Jeśli nie możesz znaleźć Client ID lub Client Secret, skontaktuj się z pomocą techniczną GoPay lub administratorem swojego konta. Parametry te mogą być niedostępne w standardowym koncie sprzedawcy.

NowPayments

NOWPayments obsługuje sprzedawców z większości krajów na całym świecie. Ponieważ usługa przetwarza płatności kryptowalutowe, dostępność może zależeć od lokalnych przepisów i obowiązujących sankcji. Przed połączeniem integracji zalecamy sprawdzenie aktualnej listy obsługiwanych jurysdykcji.

Aby skonfigurować integrację, kliknij NowPayments blok, a następnie kliknij przycisk + Konto .

Aby zintegrować NOWPayments, musisz mieć zarejestrowane NOWPayments konto. Uzupełnij następujące ustawienia w Kwiga:

Alias konta — wprowadź dowolną nazwę integracji. Ta nazwa jest wyświetlana tylko na Twoim koncie Kwiga wśród podłączonych systemów płatności.

Klucz API — skopiuj klucz API z panelu NOWPayments :
Ustawienia → Klucze API.

Sekret IPN — skopiuj lub wygeneruj sekret IPN w:
Ustawienia → Ustawienia IPN.

Tryb testowy — włącz tę opcję, jeśli korzystasz ze środowiska Sandbox . Pozostaw ją wyłączoną, aby akceptować płatności kryptowalutowe na żywo.

Po uzupełnieniu wszystkich pól kliknij Zapisz.