Comment intégrer un système de paiement sur Kwiga

La plateforme Kwiga vous permet de configurer l’acceptation des paiements des étudiants via des intégrations avec des systèmes de paiement. Grâce à l’intégration, vous pouvez accepter les paiements par carte des étudiants, proposer des paiements échelonnés et un accès par abonnement.

Pour configurer l’intégration, allez dans le menu supérieur Paramètres - Intégrations - Systèmes de paiement :

Sélectionnez dans la liste le nom du système que vous devez configurer.

Dans la nouvelle fenêtre, renseignez les paramètres et Enregistrez.

Pour le moment, les systèmes de paiement suivants sont disponibles à l’intégration, et la liste s’élargit progressivement. Si vous ne voyez pas le système de paiement dont vous avez besoin, écrivez-nous sur Telegram.

plata by mono (acquisition par monobank)

Ouvrez un compte d’entrepreneur individuel dans l’application monobank ou un compte d’entreprise chez Universal Bank en appelant le 0 800 300 200.
(L’ouverture et la gestion des comptes d’entrepreneur individuel chez Monobank sont gratuites. L’ouverture prend 2 minutes). 

Pour ouvrir un compte d’entrepreneur individuel :
1. Ouvrez l’application monobank
2. Faites glisser vers le bas

3. Appuyez sur « ouvrir une carte ou un compte d’entrepreneur individuel »

4. Sélectionnez « compte d’entrepreneur individuel »

5. Remplissez le formulaire et envoyez la demande. Remplissez le formulaire de demande de connexion. Cela prend 2 minutes. Après avoir rempli le formulaire, dans les 24 heures, vous recevrez un message de confirmation de connexion et des instructions.

Attendez que l’acquisition soit connectée. Vous recevrez une notification push dans l’application monobank.

Accédez au compte d’entrepreneur individuel

Sélectionnez la section Acquiring->internet

*Si vous n’avez pas la page "internet", cela signifie :
Que vous n’avez pas laissé de demande pour connecter l’acquisition internet de monobank ? Vous pouvez la soumettre via le lien https://www.monobank.ua/e-comm
Или Vous n’avez pas encore obtenu l’accès à la réception des paiements. Veuillez patienter :)

Dans la fenêtre qui s’ouvre, cliquez sur create token, puis copiez-le

Indiquez le Alias du compte, c’est ainsi que cette intégration sera affichée sur la plateforme Kwiga, collez le token copié dans le champ API Token, puis cliquez sur Enregistrer.

Le système de paiement plata by mono permet d’accepter des paiements uniquement dans trois devises : EUR, USD, UAH

PayPal

Cliquez sur l’icône du logo PayPal, puis cliquez sur le bouton +Compte et renseignez les paramètres de base :

Pour connecter PayPal à la plateforme, vous devez avoir un compte professionnel enregistré sur paypal.com. Connectez-vous à votre compte PayPal et suivez le lien. Ensuite, en bas de la page, trouvez Connect to an e-commerce platform et cliquez sur Get Started.

Pour intégrer ce système de paiement, vous devez obtenir des identifiants uniques – Client ID et Secret – et saisir ces données dans les champs de paramètres correspondants dans Kwiga. Assurez-vous de copier les données (client ID et clé secrète) pour Live (la position du curseur est indiquée par la flèche rouge sur la capture d’écran), et non pour Sandbox. Si vous voyez le message You're in sandbox mode, vous devez basculer le curseur sur Live.

Indiquez également le Alias du compte - le nom de cette intégration dans Kwiga, c’est-à-dire comment le compte sera affiché sur la plateforme, puis cliquez sur Enregistrer.

WayForPay

Cliquez sur le bloc WayForPay, puis sur le bouton +Compte.

Pour configurer l’intégration, vous devez avoir un compte sur le site WayForPay. Accédez à la page Paramètres de la boutique et sélectionnez la boutique requise. Ensuite, dans le bloc Informations du marchand, copiez les données.

Saisissez les valeurs MERCHANT LOGIN et MERCHANT SECRET KEY dans les champs correspondants du formulaire des paramètres d’intégration dans Kwiga.

MERCHANTPASSWORD - ce champ est facultatif. Il est utilisé uniquement si vous prévoyez d’accepter des paiements récurrents (abonnements) et de permettre aux clients d’annuler eux-mêmes les paiements récurrents dans leur compte étudiant. Pour obtenir ce mot de passe, contactez l’assistance Wayforpay.

Assurez-vous que l’envoi de Post vers returnUrl lors de la redirection du client depuis la page de paiement est désactivé dans les paramètres de votre boutique, dans le bloc Notifications (le commutateur marqué doit être désactivé, gris).

LIQPAY

Cliquez sur le bloc nommé LiqPay, puis sur le bouton +Compte.

Pour intégrer LiqPay à Kwiga, vous devez créer et activer un compte dans LiqPay. Après l’activation de l’entreprise, accédez à la page principale. Copiez les valeurs des clés publique et privée et collez-les dans les champs correspondants du formulaire Paramètres LiqPay, indiquez l’alias du compte (le nom sous lequel cette intégration apparaîtra sur la plateforme), puis cliquez sur Enregistrer.

Stripe

Cliquez sur le bloc nommé Stripe puis sur +Compte.

Pour intégrer Stripe à Kwiga, vous devrez créer et activer un compte Stripe. Après sa création, accédez à la section « Developers » et ouvrez l’onglet « API keys ».

Copiez les valeurs Publishable key et Secret key, puis collez-les dans les champs correspondants pour configurer l’intégration. Indiquez également l’alias du compte (le nom sous lequel cette intégration apparaîtra sur la plateforme), puis cliquez sur Enregistrer.

Ajout de la TVA lors du paiement via Stripe

Le système de paiement Stripe vous permet d’ajouter automatiquement la TVA au prix du cours. Dans les paramètres Stripe, vous pouvez indiquer une liste de pays pour lesquels la taxe doit s’appliquer. Lors du passage au paiement, le client pourra choisir son pays et, en fonction de ce choix, Stripe ajoutera ou non la TVA au montant.

Pour que cela fonctionne correctement sur la plateforme Kwiga, lors de la configuration de l’offre, vous devez désactiver l’option « le prix inclut la TVA ». Cela permettra à Stripe de déterminer lui-même la localisation du client et, si nécessaire, d’appliquer la taxe appropriée.

FONDY

Cliquez sur le bloc correspondant avec le logo Fondy et cliquez sur +Account.

Pour intégrer, vous devez être enregistré dans le système Fondy. Et remplir les paramètres dans Kwiga :

Alias du compte - le nom du compte dans Kwiga, tel qu’il sera affiché dans la liste des comptes sur la plateforme.

Merchant ID - le service Fondy vous attribue ce paramètre ; vous pouvez le trouver dans votre compte Fondy sur la page Paramètres du marchand → Technique. Copiez la valeur du champ Merchant ID et saisissez-la dans le champ correspondant des paramètres dans Kwiga.

Clé de paiement - accédez à votre compte Fondy et ouvrez la page Paramètres du marchand → Technique. Ensuite, copiez la valeur du champ Payment key.

Devises autorisées - sélectionnez la devise dans laquelle votre compte marchand dans Fondy est connecté ; vous pouvez уточнить ces détails auprès du support.

Et cliquez sur Enregistrer.

Assurez-vous également que la méthode de redirection correcte est définie. Pour cela, allez dans Fondy -> Merchant settings -> Technical > payment page settings, dans le champ "Redirect method to the result page", la valeur doit être POST (si une autre valeur est définie, elle doit être remplacée par POST).

Coin Payments

Pour configurer l’intégration, cliquez sur le bloc nommé Coin Payments, puis sur le bouton +Account.

Pour intégrer, vous devez être enregistré dans CoinPayments. Et remplir les paramètres dans Kwiga :

Alias du compte - le nom du compte sur la plateforme Kwiga, qui sera affiché dans la liste des systèmes de paiement ajoutés.

Clé publique - copiez la valeur du champ Public Key dans votre compte sur la page https://www.coinpayments.net/acct-api-keys

Clé privée - copiez la valeur du champ Private Key dans votre compte sur la page https://www.coinpayments.net/acct-api-keys

IPN Secret - indiquez et copiez la valeur du champ IPN Secret sur la page des paramètres du marchand https://www.coinpayments.net/acct-settings.

Votre Merchant ID - copiez la valeur du champ Your Merchant ID sur la page des paramètres de base https://www.coinpayments.net/acct-settings

Une fois tous les champs remplis, cliquez sur Enregistrer.

Dans votre compte Coinpayments, ouvrez Merchant Settings et saisissez https://cryptobalance.kwiga.com/coinpayment/ipn dans le champ IPN Secret

InterKassa

Alias du compte - c’est le nom visible uniquement par vous pour identifier ce système de paiement. Il s’affiche dans les rapports de paiement et les offres.

Client ID peut être trouvé via le lien https://portal.interkassa.com/account/checkout

Client Secret - se trouve dans le champ Secret key

API Key - se trouve dans la section API

Clé secrète - doit être prise dans la section de vérification de propriété du site. Vous n’avez pas besoin d’ajouter un fichier avec le contenu indiqué ; il suffit de copier la valeur indiquée sur la plateforme Kwiga, d’enregistrer l’ajout du compte, puis de cliquer sur Confirm dans InterKassa.

Allpay

Connectez-vous à votre compte, allez dans Settings->API Integration->Create login/key pair.

Ensuite, allez sur la plateforme Kwiga, ouvrez Settings - Integrations - Payment systems - Allpay et cliquez sur ajouter. Remplissez les champs requis pour ajouter :

Alias du compte - le nom du compte sur la plateforme Kwiga, qui sera affiché dans la liste des systèmes de paiement ajoutés. Cela peut être n’importe quel nom clair pour vous.

API login - Copiez ce qui est affiché dans la ligne correspondante dans Allpay

API key - Copiez ce qui est affiché dans la ligne correspondante dans Allpay

PayU

Connectez-vous à votre compte, ouvrez Online Payments - My shops.

Cliquez sur le nom de la boutique que vous souhaitez connecter.

Ensuite, allez dans l’onglet POS et cliquez à nouveau sur le nom de la boutique :

Les paramètres et les informations requises se chargeront pour vous (surlignés en bleu).

Alias du compte - le nom du compte sur la plateforme Kwiga, qui sera affiché dans la liste des systèmes de paiement ajoutés. Cela peut être n’importe quel nom clair pour vous.

POS ID - Copiez ce qui est affiché dans la ligne correspondante à côté de POS ID (pos_id).

Deuxième clé (MD5) - Copiez ce qui est affiché dans la ligne correspondante dans PayU.

Przelewy 24

Après votre inscription dans le système Przelewy24, vous devez accéder aux paramètres et créer une intégration API. Veuillez noter que pour fonctionner et accepter des paiements, vous devez utiliser le service Przelewy24 - version de production. Utilisez les instructions du système de paiement https://developers.przelewy24.pl/index.php?en#tag/Set-up-and-test-your-accounts/Build-API-integration. 

Après cela, accédez à la plateforme Kwiga, ouvrez Paramètres - Intégrations - Systèmes de paiement - Przelewy24 et cliquez sur ajouter. Remplissez les champs requis pour l’ajouter :

Alias du compte - le nom du compte sur la plateforme Kwiga qui sera affiché dans la liste des systèmes de paiement ajoutés. Il peut s’agir de n’importe quel nom qui vous convient.

MerchantId - il s’agit de votre identifiant de connexion pour accéder à votre compte Przelewy24 ; il aurait dû être envoyé dans l’e-mail d’inscription confirmant votre enregistrement (e-mail de confirmation après le processus d’inscription). 

Clé API -  copiez la valeur du champ de clé API (en cliquant sur le bouton afficher pour la faire apparaître). 

Crc - copiez la valeur du champ de clé CRC (en cliquant sur le bouton afficher pour la faire apparaître). 

Il est recommandé d’ajouter l’IP 159.69.103.40 à la liste blanche dans le système de paiement.

Klarna

Connectez-vous à votre compte Klarna et ouvrez la section Paramètres de paiement (en bas).

Sélectionnez les identifiants API Klarna

Cliquez sur +Générer de nouveaux identifiants API Klarna

Après cela, accédez à la plateforme Kwiga, ouvrez Paramètres - Intégrations - Systèmes de paiement - Kalrna et cliquez sur ajouter. Remplissez les champs requis pour l’ajouter :

Alias du compte - le nom du compte sur la plateforme Kwiga qui sera affiché dans la liste des systèmes de paiement ajoutés. Il peut s’agir de n’importe quel nom qui vous convient.

UID - copiez et collez la valeur indiquée dans le champ Username (UID) dans Klarna.

Mot de passe -  copiez et collez la valeur indiquée dans le champ Password dans Klarna.

RedSys

Vous recevez les informations de connexion dans l’e-mail lors de l’ouverture du compte. 

Alias du compte - le nom du compte sur la plateforme Kwiga qui sera affiché dans la liste des systèmes de paiement ajoutés. Il peut s’agir de n’importe quel nom qui vous convient.

DS_MERCHANT_MERCHANTCODE - numéro du marchand

DS_MERCHANT_TERMINAL et DS_MERCHANT_CURRENCY sont renseignés comme indiqué dans l’e-mail. Si vous n’avez plus l’e-mail, contactez l’assistance RedSys.

Nous attirons également votre attention sur le fait qu’un compte RedSys est initialement ouvert en mode test, ce qui signifie que vous ne pourrez pas accepter de vrais paiements. Pour accepter des paiements, le compte doit être basculé en mode Live dans le module d’administration. Après cela, vous recevrez un autre e-mail du support technique BBVA avec des instructions supplémentaires pour configurer l’environnement réel (Production) et activer votre TPV virtuel.