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

Kwiga La plateforme vous permet de configurer l’acceptation des paiements des étudiants grâce à 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, accédez au 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 Enregistrer.

Pour le moment, les systèmes de paiement suivants sont disponibles pour 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 app
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 soumettez la demande. Remplissez le formulaire de demande de connexion. Cela prend 2 minutes. Après avoir rempli le formulaire, vous recevrez dans les 24 heures un message de confirmation de connexion et des instructions.

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

Accédez au compte d’entrepreneur individuel

Sélectionnez la Acquisition->internet section

*Si vous n’avez pas la page « internet », cela signifie :
Vous n’avez pas envoyé de demande pour connecter l’acquisition en ligne de monobank ? Vous pouvez la soumettre via le lien https://www.monobank.ua/e-comm
ou Vous n'avez pas encore reçu l'autorisation d'accepter des paiements. Veuillez patienter :)

Dans la fenêtre qui s'ouvre, cliquez sur créer un jeton, puis copiez-le

Indiquez le Alias du compte, sous lequel cette intégration sera affichée sur la Kwiga plateforme, collez le jeton copié dans le champ Jeton API et cliquez sur Enregistrer.

Le plata by mono système de paiement 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 disposer d'un compte professionnel enregistré sur paypal.com.

Connectez-vous à votre compte PayPal et suivez ce lien :
https://developer.paypal.com/home/

Passez en mode Live : le bouton bascule se trouve en haut du menu. Le bouton doit être réglé sur « Live”.

Après avoir passé votre compte en mode Live, sélectionnez « Apps & Credentials » dans le menu :
https://developer.paypal.com/dashboard/applications/live

Choisissez (cliquez sur) le nom de l'application ou créez-en une nouvelle.

Assurez-vous de copier les identifiants (Client ID and Secret Key) pour l'environnement Live (la position du bouton bascule est indiquée par la flèche rouge dans la capture d'écran), et non pour Sandbox.

Si vous voyez le message « You're in sandbox mode », vous devez passer le bouton bascule sur Live.

Le PayPal l’interface peut varier selon le pays d’enregistrement de votre compte. Un autre emplacement du bouton bascule est présenté ci-dessous.

Indiquez également le Alias du compte — le nom de cette intégration dans Kwiga, qui 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 disposer d’un compte sur le site Web de WayForPay . Accédez à la page Paramètres de la boutique et sélectionnez la boutique requise. Ensuite, dans le bloc Détails du marchand , copiez les données.

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

MERCHANTPASSWORD - ce champ est facultatif. Il est utilisé uniquement lorsque vous prévoyez d’accepter des paiements récurrents (abonnements) et d’autoriser les clients à 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 l’URL de retour 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 (l’interrupteur indiqué 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 avoir activé 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 de paramètres LiqPay . Indiquez l’alias du compte (le nom sous lequel cette intégration apparaîtra sur la plateforme), puis cliquez sur Enregistrer.

Veuillez noter: si votre Liqpay le compte est en cours de vérification et n'a pas encore été approuvé pour accepter les paiements, nous vous recommandons d'indiquer le lien de la page de l'offre dans le système de paiement au lieu du lien de paiement.

Stripe

Cliquez sur le bloc nommé Stripe puis +Compte.

Pour intégrer Stripe à Kwiga, vous devrez créer et activer un compte Stripe . Après l'avoir créé, accédez à la section «Développeurs» et ouvrez l'onglet “Clés API” .

Copiez les valeurs de Clé publiable et Clé secrète , 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) et cliquez sur Enregistrer.

Ajout de 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 auxquels la taxe doit être appliquée. Lors du passage au paiement, le client pourra choisir son pays et, selon ce choix, Stripe ajoutera ou non la TVA au montant.

Pour que cette fonctionnalité fonctionne correctement sur la plateforme Kwiga , vous devez désactiver l'option “Le prix inclut la TVA” lors de la configuration de l'offre. Cela permet à Stripe de déterminer la localisation du client et, si nécessaire, de facturer la taxe applicable.

Lors du paiement, Stripe calcule la taxe en fonction de l'adresse de facturation fournie par le client et de vos paramètres fiscaux dans Stripe. Si le taux de taxe applicable est configuré pour le pays du client, la taxe sera automatiquement ajoutée au total de la commande. Pour les autres pays, la taxe peut être de 0 %.

Veuillez noter que les pays et les taux de taxe doivent être configurés à l’avance dans votre Stripe compte. La connexion de Stripe à Kwiga n’affecte pas les Liens de paiement Stripe existants — ils continueront de fonctionner avec leurs paramètres actuels.

En savoir plus sur la configuration de Stripe Taxe : https://docs.stripe.com/tax/set-up

FONDY

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

Pour l’intégration, vous devez être inscrit dans le système Fondy . Remplissez ensuite 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.

ID marchand - 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 ID marchand 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 . Copiez ensuite la valeur du champ Clé de paiement.

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

Et cliquez sur Enregistrer.

Assurez-vous également que la méthode de redirection correcte est définie. Pour ce faire, accédez à Fondy -> Paramètres du marchand -> Technique > paramètres de la page de paiement, dans le champ "Méthode de redirection vers la page de résultat" elle doit être définie sur 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 +Compte .

Pour intégrer, vous devez être inscrit sur CoinPayments. Remplissez ensuite 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 depuis le champ Clé publique dans votre compte, sur la page https://www.coinpayments.net/acct-api-keys

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

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

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

Après avoir rempli tous les champs, cliquez sur Enregistrer.

Dans votre Coinpayments compte, ouvrez Paramètres marchand et saisissez https://cryptobalance.kwiga.com/coinpayment/ipn dans le champ Secret IPN

InterKassa

Alias du compte - il s'agit du nom visible uniquement par vous pour identifier ce système de paiement. Il est affiché dans les rapports de paiement et les offres. 

ID client est disponible via le lien

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

 Secret client - se trouve dans le champ Clé secrète 

 Clé API - se trouve dans la section API

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

Allpay

Connectez-vous à votre compte, accédez à Paramètres->Intégration API->Créer une paire identifiant/clé.

Ensuite, accédez à la plateforme Kwiga, ouvrez Paramètres - Intégrations - Systèmes de paiement - 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. Il peut s'agir de tout nom qui vous convient. 

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

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

PayU

Connectez-vous à votre compte, ouvrez Paiements en ligne - Mes boutiques.

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

Ensuite, accédez à l’onglet POS et cliquez à nouveau sur le nom de la boutique :

Les paramètres et les informations requises se chargeront automatiquement (mis en évidence 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. Il peut s’agir de n’importe quel nom clair pour vous. 

ID POS - Copiez ce qui est affiché dans la ligne correspondante à côté de l’ID POS (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 Przelewy24 service - 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. 

Ensuite, 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 clair pour vous.

ID marchand - il s’agit de votre identifiant pour accéder à votre compte Przelewy24 ; il aurait dû vous ê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 l’afficher). 

CRC - copiez la valeur du champ de clé CRC (en cliquant sur le bouton Afficher pour l’afficher). 

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

Klarna

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

Sélectionnez Identifiants API Klarna

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

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

Alias du compte - le nom du compte sur la Kwiga plateforme 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 Nom d’utilisateur (UID) dans Klarna.

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

RedSys

Vous recevez les informations de connexion par 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 de 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 paiements réels. Pour accepter des paiements, le compte doit être basculé en mode Live dans le module d'administration. Vous recevrez ensuite un autre e-mail de BBVA l'assistance technique contenant des instructions supplémentaires pour configurer l'environnement réel (Production) et activer votre TPV virtuel.

Paddle

Paddle agit en tant que Merchant of Record et prend en charge les vendeurs (entreprises et entrepreneurs individuels) de la plupart des pays du monde, y compris les États membres de l'Union européenne, l'Ukraine, les États-Unis, le Canada, le Royaume-Uni, l'Australie et bien d'autres. Avant de vous inscrire, nous vous recommandons de consulter la liste actualisée des pays pris en charge dans la documentation Paddle.

Pour configurer l'intégration, cliquez sur le bloc Paddle puis cliquez sur le bouton + Compte .

Pour intégrer Paddle, vous devez disposer d'un compte Paddle enregistré. Une fois votre compte configuré, effectuez les réglages suivants dans Kwiga :

Alias du compte — saisissez n'importe quel nom pour l'intégration. Ce nom s'affiche uniquement dans votre compte Kwiga parmi vos systèmes de paiement connectés.

Jeton côté client — copiez le Jeton côté client depuis votre Paddle tableau de bord :

Outils de développement → Authentification → Jetons côté client.

Clé API — copiez la Clé API depuis votre Paddle tableau de bord :

Outils de développement → Authentification → Clés API.

Mode test — activez cette option si vous utilisez l’environnement Paddle Sandbox .

Laissez-la désactivée pour accepter les paiements réels.

Après avoir rempli tous les champs, cliquez sur Enregistrer.

Mollie

Mollie prend uniquement en charge les entreprises et les entrepreneurs individuels enregistrés dans des pays de l’Espace économique européen (EEE), ainsi qu’au Royaume-Uni et en Suisse. Pour vous inscrire, vous devez disposer d’une personne morale ou d’une entreprise individuelle (ou d’un enregistrement commercial équivalent) dans l’un des pays pris en charge.

Pour configurer l’intégration, cliquez sur le bloc Mollie , puis cliquez sur le bouton + Compte .

Pour finaliser l’intégration, vous devez avoir un compte Mollie . Remplissez les champs suivants :

Alias du compte — saisissez n’importe quel nom pour l’intégration. Ce nom s’affiche uniquement dans votre compte Kwiga parmi vos systèmes de paiement connectés.

Clé secrète — copiez la clé API en production depuis votre tableau de bord Mollie :

Développeurs → Clés API.

Enregistrer les informations de carte pour de futurs prélèvements — lorsqu’elle est activée, Kwiga enregistre le jeton de paiement, ce qui permet des prélèvements récurrents sans demander au client de ressaisir les informations de sa carte (à condition que le mode de paiement sélectionné prenne en charge les paiements récurrents).

Après avoir rempli tous les champs, cliquez sur Enregistrer.

GoPay

GoPay s'adresse principalement aux entreprises et aux entrepreneurs d'Europe centrale. L'intégration est disponible pour les personnes morales et les entrepreneurs de République tchèque, de Slovaquie, de Pologne et de certains autres pays de la région. La liste complète des pays pris en charge est disponible sur le site de GoPay.

Pour configurer l'intégration, cliquez sur le bloc GoPay, puis sur le bouton +Compte.

Pour configurer l'intégration, vous devez disposer d'un compte GoPay. Remplissez les champs suivants :

Alias du compte — un nom de votre choix pour l'intégration. Il s'affiche uniquement dans votre compte Kwiga parmi les systèmes de paiement connectés.

Client ID — disponible dans les paramètres API de votre projet dans votre compte GoPay (API → Projet → Client ID).

Client Secret — copiez la clé secrète depuis les paramètres API de votre projet (API → Projet → Client Secret).

GoID (Merchant ID) — copiez l'identifiant du marchand depuis votre compte GoPay (Business Accounts → détails du compte → GoID).

Mode test — activez cette option si vous utilisez l'environnement de test de GoPay.

Après avoir rempli tous les champs, cliquez sur Enregistrer.

Si vous ne trouvez pas le Client ID ou le Client Secret, contactez le service d'assistance de GoPay ou l'administrateur de votre compte. Ces paramètres peuvent ne pas être disponibles dans le compte marchand standard.

NowPayments

NOWPayments prend en charge les vendeurs de la plupart des pays du monde. Étant donné que le service traite des paiements en cryptomonnaies, la disponibilité peut dépendre des réglementations locales et des sanctions applicables. Avant de connecter l’intégration, nous vous recommandons de consulter la liste actuelle des juridictions prises en charge.

Pour configurer l’intégration, cliquez sur NowPayments bloc, puis cliquez sur le + Compte bouton.

Pour intégrer NOWPayments, vous devez disposer d’un compte NOWPayments enregistré. Effectuez les réglages suivants dans Kwiga:

Alias du compte — saisissez n’importe quel nom pour l’intégration. Ce nom s’affiche uniquement dans votre compte Kwiga parmi vos systèmes de paiement connectés.

Clé API — copiez la Clé API depuis votre NOWPayments tableau de bord :
Paramètres → Clés API.

Secret IPN — copiez ou générez le Secret IPN dans :
Paramètres → Paramètres IPN.

Mode test — activez cette option si vous utilisez l’environnement Sandbox . Laissez-la désactivée pour accepter les paiements en cryptomonnaie réels.

Après avoir rempli tous les champs, cliquez sur Enregistrer.