How to integrate a payment system on Kwiga

Kwiga platform lets you set up payment acceptance from students through integrations with payment systems. With the integration, you can accept card payments from students, offer installments, and subscription-based access.

To set up the integration, go to the top menu Settings - Integrations - Payment systems:

Select the name of the system you need to configure from the list.

In the new window, fill in the settings and Save.

At the moment, the following payment systems are available for integration, and the list is gradually expanding. If you do not see the payment system you need, write to us on Telegram.

plata by mono (acquiring by monobank)

Open a sole proprietor account in the monobank app or a company account at Universal Bank by calling 0 800 300 200.
(Opening and maintaining sole proprietor accounts at Monobank is free. Opening takes 2 minutes). 

To open a sole proprietor account:
1. Open the monobank app
2. Swipe down

3. Tap “open a card or sole proprietor account”

4. Select “sole proprietor account”

5. Fill out the form and submit the application. Fill out the application form for connection. It takes 2 minutes. After filling out the form, within 24 hours you will receive a connection confirmation message and instructions.

Wait for acquiring to be connected. You will receive a push notification in the monobank app.

Go to the sole proprietor account

Select the Acquiring->internet section

*If you do not have the "internet" page, this means:
That you did not leave a request to connect internet acquiring from monobank? You can submit it via the link https://www.monobank.ua/e-comm
or You have not yet been granted access to receive payments. Please wait :)

In the window that opens, click create token, then copy it

Specify the Account alias, which is how this integration will be displayed on the Kwiga platform, paste the copied token into the API Token field, and click Save.

The plata by mono payment system allows accepting payments only in three currencies: EUR, USD, UAH

PayPal

Click the PayPal logo icon, then click the +Account button and fill in the basic settings:

To connect PayPal to the platform, you need to have a registered business account on paypal.com.

Log in to your PayPal account and follow this link:
https://developer.paypal.com/home/

Switch to Live mode: the toggle is located at the top of the menu. The switch should be set to “Live”.

After switching your account to Live mode, select “Apps & Credentials” from the menu:
https://developer.paypal.com/dashboard/applications/live

Choose (click on) the application name or create a new one.

Make sure you copy the credentials (Client ID and Secret Key) for the Live environment (the toggle position is indicated by the red arrow in the screenshot), not for Sandbox.

If you see the message “You're in sandbox mode”, you need to switch the toggle to Live.

The PayPal interface may vary depending on the country of your account registration. An alternative toggle placement is shown below.

Also specify the Account Alias — the name of this integration in Kwiga, which will be displayed on the platform, and click “Save”.

WayForPay

Click the WayForPay block and click the +Account button.

To set up the integration, you must have an account on the WayForPay website. Go to the Store settings page and select the required store. Then, in the Merchant details block, copy the data.

Enter the MERCHANT LOGIN and MERCHANT SECRET KEY values into the corresponding fields in the integration settings form in Kwiga.

MERCHANTPASSWORD - this field is optional. It is used only when you plan to accept recurring payments (subscriptions) and allow clients to cancel recurring payments themselves in their student account. To obtain this password, contact Wayforpay support.

Make sure that sending Post to return Url when redirecting the client from the payment page is disabled in your store settings in the Notifications block (the marked switch must be off, gray).

LIQPAY

Click the block named LiqPay and then the +Account button.

To integrate LiqPay with Kwiga, you need to create and activate an account in LiqPay. After activating the company, go to the main page. Copy the public and private key values and paste them into the corresponding fields of the LiqPay Settings form, specify the account alias (what this integration will be called on the platform), and click Save.

Please note: if your Liqpay account is under review and has not yet been approved for accepting payments, we recommend specifying the offer page link in the payment system instead of the payment link.

Stripe

Click the block named Stripe and then +Account.

To integrate Stripe with Kwiga, you will need to create and activate a Stripe account. After creating it, go to the “Developers” section and open the “API keys” tab.

Copy the Publishable key and Secret key values, then paste them into the corresponding fields for integration setup. Also specify the account alias (what this integration will be called on the platform) and click Save.

Adding VAT when paying via Stripe

The Stripe payment system allows you to automatically add VAT to the course price. In Stripe settings, you can specify a list of countries for which the tax should be applied. When proceeding to payment, the client will be able to choose their country, and depending on this choice, Stripe will either add VAT to the amount or not.

For this feature to work correctly on the Kwiga platform, you need to disable the “Price includes VAT” option when setting up the offer. This allows Stripe to determine the customer's location and, if necessary, charge the applicable tax.

During payment, Stripe calculates the tax based on the billing address provided by the customer and your tax settings in Stripe. If the applicable tax rate is configured for the customer's country, the tax will be automatically added to the order total. For other countries, the tax may be 0%.

Please note that countries and tax rates must be configured in advance in your Stripe account. Connecting Stripe to Kwiga does not affect existing Stripe Payment Links — they will continue to work with their current settings.

Learn more about setting up Stripe Tax: https://docs.stripe.com/tax/set-up

FONDY

Click the corresponding block with the Fondy logo and click +Account.

To integrate, you need to be registered in the Fondy system. And fill in the settings in Kwiga:

Account alias - the account name in Kwiga, how it will be displayed in the list of accounts on the platform.

Merchant ID - the Fondy service assigns this parameter to you; it can be found in your Fondy account on the Merchant settings → Technical page. Copy the value from the Merchant ID field and enter it in the corresponding field in the settings in Kwiga.

Payment key - go to your Fondy account and open the Merchant settings → Technical page. Then copy the value from the Payment key field.

Allowed currencies - select the currency in which your merchant account in Fondy is connected; you can уточнить these details with support.

And click Save.

Also, make sure that the correct redirect method is set for you. This can be done by going to Fondy -> Merchant settings -> Technical > payment page settings, in the field "Redirect method to the result page" it should be POST (if another value is set, it must be changed to  POST). 

Coin Payments

To set up the integration, click the block named Coin Payments and then the +Account button.

To integrate, you need to be registered in CoinPayments. And fill in the settings in Kwiga:

Account alias - the account name on the Kwiga platform, which will be displayed in the list of added payment systems.

Public key - copy the value from the Public Key field in your account on the page https://www.coinpayments.net/acct-api-keys

Private Key - copy the value from the Private Key field in your account on the page https://www.coinpayments.net/acct-api-keys

IPN Secret - specify and copy the value from the IPN Secret field on the merchant settings page https://www.coinpayments.net/acct-settings.

Your Merchant ID - copy the value from the Your Merchant ID field on the basic settings page https://www.coinpayments.net/acct-settings

After all fields are filled in, click Save.

In your Coinpayments account, open Merchant Settings and enter https://cryptobalance.kwiga.com/coinpayment/ipn in the IPN Secret field

InterKassa

Account alias - this is the name visible only to you to identify this payment system. It is displayed in payment reports and offers. 

Client ID can be found at the link

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

 Client Secret - is located in the Secret key field 

 API Key - is located in the API section

Secret key - must be taken from the site ownership verification section. You do not need to add a file with the specified content; it is enough to copy the specified value to the Kwiga platform, save the account addition, and after that click Confirm in InterKassa.

Allpay

Log in to your account, go to Settings->API Integration->Create login/key pair.

After that, go to the Kwiga platform, open Settings - Integrations - Payment systems - Allpay and click add. Fill in the required fields to add:

Account alias - the account name on the Kwiga platform, which will be displayed in the list of added payment systems. This can be any name that is clear to you. 

API login - Copy what is displayed in the corresponding line in Allpay

API key - Copy what is displayed in the corresponding line in Allpay

PayU

Log in to your account, open Online Payments - My shops.

Click the name of the shop you want to connect.

After that, go to the POS tab and click the shop name once again:

The settings and required parameters will load for you (highlighted in blue).

Account alias - the account name on the Kwiga platform, which will be displayed in the list of added payment systems. This can be any name that is clear to you. 

POS ID - Copy what is displayed in the corresponding line next to POS ID (pos_id).

Second key (MD5) - Copy what is displayed in the corresponding line in PayU. 

Przelewy 24

After registering in the Przelewy24 system, you need to go to the settings and create an API integration. Please note that to operate and accept payments, you need to use Przelewy24 service - production version. Use the instructions from the payment system https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

After that, go to the Kwiga platform, open Settings - Integrations - Payment systems - Przelewy24 and click add. Fill in the required fields to add it:

Account alias - the account name on the Kwiga platform that will be displayed in the list of added payment systems. It can be any name that is clear to you.

Merchant ID - this is your login for accessing your Przelewy24 account; it should have been sent in the registration email confirming your registration (confirmation e-mail after registration process). 

API key -  copy the value from the API key field (by clicking the show button to display it). 

CRC - copy the value from the CRC key field (by clicking the show button to display it). 

It is recommended to add IP 159.69.103.40 to the whitelist in the payment system.

Klarna

Log in to your Klarna account and open the Payment Settings section (at the bottom).

Select Klarna API Credentials

Click +Generate new Klarna API credentials

After that, go to the Kwiga platform, open Settings - Integrations - Payment systems - Klarna and click add. Fill in the required fields to add it:

Account alias - the account name on the Kwiga platform that will be displayed in the list of added payment systems. It can be any name that is clear to you.

UID - copy and paste the value specified in the Username (UID) field in Klarna.

Password -  copy and paste the value specified in the Password field in Klarna.

RedSys

You receive the connection details in the email when opening the account. 

Account alias - the account name on the Kwiga platform that will be displayed in the list of added payment systems. It can be any name that is clear to you.

DS_MERCHANT_MERCHANTCODE - merchant number

DS_MERCHANT_TERMINAL and DS_MERCHANT_CURRENCY are filled in as indicated in the email. If you no longer have the email, contact RedSys support.

We also draw your attention to the fact that a RedSys account is initially opened in test mode, which means you will not be able to accept real payments. To accept payments, the account must be switched to Live mode in the administration module. After that, you will receive another email from BBVA technical support with further instructions for setting up the real environment (Production) and activating your virtual TPV.

Paddle

Paddle acts as a Merchant of Record and supports sellers (companies and sole proprietors) from most countries worldwide, including the European Union member states, Ukraine, the United States, Canada, the United Kingdom, Australia, and many others. Before registering, we recommend checking the up-to-date list of supported countries in the Paddle documentation.

To configure the integration, click the Paddle block, then click the + Account button.

To integrate Paddle, you must have a registered Paddle account. Once your account is set up, complete the following settings in Kwiga:

Account alias — enter any name for the integration. This name is displayed only in your Kwiga account among your connected payment systems.

Client-side token — copy the Client-side token from your Paddle dashboard:

Developer Tools → Authentication → Client-side tokens.

API key — copy the API Key from your Paddle dashboard:

Developer Tools → Authentication → API keys.

Test mode — enable this option if you are using the Paddle Sandbox environment.

Leave it disabled to accept live payments.

After completing all fields, click Save.

Mollie

Mollie supports only businesses and sole proprietors registered in countries within the European Economic Area (EEA), as well as the United Kingdom and Switzerland. To register, you must have a legal entity or sole proprietorship (or an equivalent business registration) in one of the supported countries.

To configure the integration, click the Mollie block, then click the + Account button.

To complete the integration, you must have a Mollie account. Fill in the following fields:

Account alias — enter any name for the integration. This name is displayed only in your Kwiga account among your connected payment systems.

Secret key — copy the Live API Key from your Mollie dashboard:

Developers → API keys.

Store card details for future charges — when enabled, Kwiga stores the payment token, allowing recurring charges without requiring the customer to re-enter their card details (provided the selected payment method supports recurring payments).

After completing all fields, click Save.

NowPayments

NOWPayments supports sellers from most countries worldwide. Since the service processes cryptocurrency payments, availability may depend on local regulations and applicable sanctions. Before connecting the integration, we recommend checking the current list of supported jurisdictions.

To configure the integration, click the NowPayments block, then click the + Account button.

To integrate NOWPayments, you must have a registered NOWPayments account. Complete the following settings in Kwiga:

Account alias — enter any name for the integration. This name is displayed only in your Kwiga account among your connected payment systems.

API key — copy the API Key from your NOWPayments dashboard:
Settings → API Keys.

IPN Secret — copy or generate the IPN Secret in:
Settings → IPN settings.

Test mode — enable this option if you are using the Sandbox environment. Leave it disabled to accept live cryptocurrency payments.

After completing all fields, click Save.