How to integrate a payment system on Kwiga

Kwiga 平台允许您通过与支付系统集成来设置向学员收款。借助集成，您可以接受学员的银行卡付款、提供分期付款以及基于订阅的访问权限。

要设置集成，请转到顶部菜单 设置 - 集成 - 支付系统：

从列表中选择您需要配置的系统名称。

在新窗口中，填写设置并 保存。

目前，以下支付系统可用于集成，且列表正在逐步扩展。如果您没有看到所需的支付系统，请通过 Telegram 联系我们。

plata by mono（monobank 的收单服务）

通过拨打 0 800 300 200，在 monobank 应用中开设个体经营者账户，或在 Universal Bank 开设公司账户。
（在 Monobank 开设和维护个体经营者账户是免费的。开设只需 2 分钟）。 

开设个体经营者账户：
1. 打开 monobank 应用
2. 向下滑动

3. 点击“开设银行卡或个体经营者账户”

4. 选择“个体经营者账户”

5. 填写表单并提交申请。填写连接申请表。只需 2 分钟。填写完成后，您将在 24 小时内收到连接确认消息和说明。

等待收单服务完成连接。您将会在 monobank 应用中收到推送通知。

进入个体经营者账户

选择 Acquiring->internet 部分

*如果您没有“internet”页面，这意味着：
您没有提交连接 monobank internet acquiring 的申请吗？您可以通过此链接提交：https://www.monobank.ua/e-comm
Или 您尚未获得收款权限。请稍候 :)

在打开的窗口中，点击 create token，然后复制它

指定账户别名，即该集成在 Kwiga 平台上的显示名称，将复制的令牌粘贴到 API Token 字段中，然后点击 保存。

plata by mono 支付系统仅支持以三种货币收款：EUR、USD、UAH

PayPal

点击 PayPal 徽标图标，然后点击 +账户 按钮并填写基本设置：

要将 PayPal 连接到平台，您需要在 paypal.com 上拥有一个已注册的企业账户。登录您的 PayPal 账户并点击链接。然后在页面底部找到 Connect to an e-commerce platform 并点击 Get Started。

要集成此支付系统，您需要获取唯一标识符––Client ID 和 Secret––并将这些数据输入 Kwiga 中相应的设置字段。请确保您复制的是 Live 的数据（滑块位置如截图中的红色箭头所示），而不是 Sandbox 的数据。如果您看到消息 You're in sandbox mode，则需要将滑块切换到 Live。

另外还需指定账户别名––即该集成在 Kwiga 中的名称，也就是该账户在平台上的显示方式，然后点击 保存。

WayForPay

点击 WayForPay 模块，然后点击 +账户 按钮。

要设置集成，您必须在 WayForPay 网站上拥有账户。转到 商店设置 页面并选择所需的商店。然后在 商户详细信息 模块中复制数据。

将 MERCHANT LOGIN 和 MERCHANT SECRET KEY 的值输入到 Kwiga 集成设置表单中的相应字段。

MERCHANTPASSWORD - 此字段为可选项。仅当您计划接受周期性付款（订阅），并允许客户在其学员账户中自行取消周期性付款时才会使用。要获取此密码，请联系 Wayforpay 支持。

请确保在您的商店设置中，Notifications 模块里的 sending Post to returnUrl when redirecting the client from the payment page 已禁用（标记的开关应为关闭状态，即灰色）。

LIQPAY

点击名为 LiqPay 的模块，然后点击 +账户 按钮。

要将 LiqPay 与 Kwiga 集成，您需要在 LiqPay 中创建并激活账户。公司激活后，转到主页。复制 public 和 private key 的值，并将其粘贴到 LiqPay Settings 表单的相应字段中，指定账户别名（该集成在平台上的名称），然后点击 保存。

Stripe

点击名为 Stripe 的模块，然后点击 +账户。

要将 Stripe 与 Kwiga 集成，您需要创建并激活一个 Stripe 账户。创建完成后，转到“Developers”部分并打开 “API keys” 选项卡。

复制 Publishable key 和 Secret key 的值，然后将它们粘贴到相应的集成设置字段中。还需指定账户别名（该集成在平台上的名称），然后点击 保存。

通过 Stripe 支付时添加 VAT

Stripe 支付系统允许您自动将 VAT 添加到课程价格中。在 Stripe 设置中，您可以指定应适用税费的国家/地区列表。进入支付时，客户将能够选择其所在国家/地区，并且 Stripe 会根据该选择决定是否在金额中添加 VAT。

为了使其在 Kwiga 平台上正常运行，在设置报价时，您需要禁用选项 “价格包含 VAT”。这样 Stripe 就可以自行确定客户的位置，并在必要时收取相应的税费。

FONDY

点击带有 Fondy 徽标的相应区块，然后点击 +账户。

要进行集成，您需要先在 Fondy 系统中注册。然后在 Kwiga 中填写设置：

账户别名 - Kwiga 中的账户名称，即它在平台账户列表中的显示名称。

Merchant ID - 此参数由 Fondy 服务分配给您；您可以在 Fondy 账户中的 Merchant settings → Technical 页面找到它。复制 Merchant ID 字段中的值，并将其输入到 Kwiga 设置中的对应字段。

Payment key - 进入您的 Fondy 账户并打开 Merchant settings → Technical 页面。然后复制 Payment key 字段中的值。

允许的货币 - 选择您在 Fondy 中连接的商户账户所使用的货币；您也可以向支持团队确认这些详细信息。

然后点击 保存。

另外，请确保为您设置了正确的重定向方法。可通过前往 Fondy -> Merchant settings -> Technical > payment page settings，在“Redirect method to the result page”字段中应设置为 POST（如果设置的是其他值，则必须改为 POST）。

Coin Payments

要设置集成，请点击名为 Coin Payments 的区块，然后点击 +账户 按钮。

要进行集成，您需要先在 CoinPayments 中注册。然后在 Kwiga 中填写设置：

账户别名 - Kwiga 平台上的账户名称，将显示在已添加的支付系统列表中。

Public key - 从您账户中页面 https://www.coinpayments.net/acct-api-keys

Private Key - 从您账户中页面 https://www.coinpayments.net/acct-api-keys

IPN Secret - 在商户设置页面 https://www.coinpayments.net/acct-settings.

Your Merchant ID - 从基本设置页面 https://www.coinpayments.net/acct-settings

填写完所有字段后，点击 保存。

在您的 Coinpayments 账户中，打开 Merchant Settings，并在 IPN Secret 字段中输入 https://cryptobalance.kwiga.com/coinpayment/ipn

InterKassa

账户别名 - 这是仅您可见、用于识别此支付系统的名称。它会显示在付款报告和报价中。

Client ID 可通过以下链接找到 https://portal.interkassa.com/account/checkout

Client Secret - 位于 Secret key 字段中

API 密钥 - 位于 API 部分

Secret key - 必须从网站所有权验证部分获取。您无需添加包含指定内容的文件；只需将指定值复制到 Kwiga 平台，保存添加账户，之后在 InterKassa 中点击 Confirm。

Allpay

登录您的账户，前往 Settings->API Integration->Create login\/key pair。

之后，前往 Kwiga 平台，打开 Settings - Integrations - Payment systems - 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 集成。请注意，要进行操作并接收付款，您需要使用 Przelewy24 服务 - 生产版本。请使用支付系统中的说明 https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

之后，前往 Kwiga 平台，打开 设置 - 集成 - 支付系统 - Przelewy24 并点击添加。填写以下必填字段以完成添加：

账户别名 - Kwiga 平台上的账户名称，将显示在已添加的支付系统列表中。可以是任何您容易识别的名称。

MerchantId - 这是您登录 Przelewy24 账户的用户名；它应已在确认您注册的电子邮件中发送给您（注册流程完成后的确认邮件）。 

API key -  复制 API key 字段中的值（点击 show 按钮即可显示）。 

Crc - 复制 CRC key 字段中的值（点击 show 按钮即可显示）。 

建议将 IP 159.69.103.40 添加到支付系统的白名单中。

Klarna

登录您的 Klarna 账户并打开 Payment Settings 部分（在底部）。

选择 Klarna API Credentials

点击 +Generate new Klarna API credentials

之后，前往 Kwiga 平台，打开 设置 - 集成 - 支付系统 - Kalrna 并点击添加。填写以下必填字段以完成添加：

账户别名 - Kwiga 平台上的账户名称，将显示在已添加的支付系统列表中。可以是任何您容易识别的名称。

UID - 复制并粘贴 Klarna 中 Username (UID) 字段里指定的值。

Password -  复制并粘贴 Klarna 中 Password 字段里指定的值。

RedSys

您会在开户时收到的电子邮件中获取连接详细信息。 

账户别名 - Kwiga 平台上的账户名称，将显示在已添加的支付系统列表中。可以是任何您容易识别的名称。

DS_MERCHANT_MERCHANTCODE - 商户编号

DS_MERCHANT_TERMINAL 和 DS_MERCHANT_CURRENCY 请按照电子邮件中的说明填写。如果您已不再保留该邮件，请联系 RedSys 支持团队。

还请注意，RedSys 账户最初是以测试模式开通的，这意味着您将无法接收真实付款。要接收付款，必须在管理模块中将账户切换为 Live 模式。之后，您将收到 BBVA 技术支持发送的另一封电子邮件，其中包含设置真实环境（Production）以及激活您的虚拟 TPV 的进一步说明。