Passerelle Wix Velo

Aperçu

MakePay pour Wix utilise le plug-in de service de fournisseur de paiement de Wix Velo. Le merchant ajoute quatre fichiers MakePay JavaScript à l'éditeur Wix, installe crypto-js, connecte le fournisseur de paiement dans Paramètres > Accepter les paiements et stocke les secrets API dans Wix Secrets Manager.

À checkout, Wix appelle createTransaction(). Le fichier backend MakePay crée un lien de paiement MakePay hébergé et renvoie la redirection URL vers Wix. Lorsque MakePay confirme le paiement, un webhook signé appelle la fonction HTTP Wix et le code enregistre le paiement sur la commande Wix.

Avant de commencer

Vous aurez besoin de :

• Un magasin Wix avec le mode développeur activé
• Autorisation de modifier les fichiers backend et les plugins de service Velo
• Autorisation d'utiliser le gestionnaire de secrets Wix
• Une société MakeCrypto avec un règlement MakePay configuré
• Une clé MakePay API avec accès en écriture au lien de paiement
• Un secret MakePay webhook pour l’entreprise

Créer des informations d'identification MakePay

Dans MakeCrypto :

1. Sélectionnez l'entreprise qui doit recevoir les paiements Wix.
2. Ouvrez Wallet > Soldes et configurez le règlement.
3. Ouvrez Intégrations > Intégrations API et créez une clé API.
4. Donnez au moins la clé :
   • makepay:payment-links:read
   • makepay:payment-links:write
5. Copiez l'ID de l'entreprise, l'ID de clé API et la clé secrète API.
6. Ouvrez Merchant > Paramètres de paiement et faites pivoter ou copiez le secret webhook.

Le secret de clé API et le secret webhook sont ajoutés au gestionnaire de secrets Wix, et non au code frontal.

Ajouter des fichiers Velo Wix

Ouvrez le référentiel source MakePay Wix :

https://github.com/makecryptoio/makepay-wix

La même source est conservée dans ce monorepo sous apps/plugins/wix.

Dans Wix :

1. Ouvrez l'éditeur de site et activez le Mode Dev.
2. Sous Public et backend > Backend, créez :
   • MakePay.js
   • http-functions.js
3. Sous Service Plugins, créez un plug-in Paiement nommé MakePayPayment.
4. Copie:
   • MakePayPayment-config.js
   • MakePayPayment.js
5. Installez le package crypto-js npm à partir de Packages et applications.
6. Publier le site.

Ajouter des secrets Wix

Ouvrez Outils de développement > Secrets Manager et ajoutez :

Nom secret	Valeur
makepay_api_key_secret	La clé secrète MakePay API
makepay_webhook_secret	Le secret du MakePay webhook

Ne collez pas ces valeurs dans le code de la page ou dans les fichiers frontaux publics.

Connectez le MakePay au Wix

Ouvrez Paramètres > Accepter les paiements dans le tableau de bord Wix et connectez le fournisseur de paiement personnalisé MakePay.

Entrer:

Champ	Valeur
Identifiant d'entreprise MakePay	L’identifiant de l’entreprise MakeCrypto
ID de clé MakePay API	L’ID de clé MakePay API
Devise de règlement	Habituellement USDT

Le titre du mode de paiement checkout est :

Crypto Payment in USDT, BTC, ETH, LTC, DOGE and others

Configurer webhooks

Le point de terminaison de la fonction HTTP Wix est :

https://your-wix-domain.com/_functions/makepay_notify

Dans MakeCrypto, ouvrez Merchant > Paramètres de paiement et définissez le rappel MakePay URL sur ce point de terminaison. Le secret webhook dans Wix Secrets Manager doit correspondre au secret MakePay webhook.

Le gestionnaire Wix webhook vérifie l'en-tête X-MakePay-Signature avant de marquer toute commande comme payée.

Test checkout

1. Ajoutez un produit de faible valeur à votre panier Wix.
2. Accédez à checkout.
3. Choisissez le mode de paiement crypto MakePay.
4. Cliquez sur Passer la commande et payer.
5. Confirmez que Wix redirige vers MakePay checkout hébergé.
6. Effectuez un paiement test.
7. Confirmez que la commande du Wix est marquée comme payée après la réception du webhook.
8. Cochez Intégrations > Demandes Webhook dans MakeCrypto si la commande le fait pas de mise à jour.

Notes de sécurité

L'intégration Wix utilise l'authentification par clé API, car les fichiers du fournisseur de paiement Velo copiés par merchant ne prennent pas encore en charge le flux automatique Connect MakePay.

Gardez ces règles :

• Stockez les secrets uniquement dans Wix Secrets Manager.
• Utilisez une clé API spécifique au MakePay, et non une clé interne large.
• N’accordez pas d’étendues d’envoi de portefeuille ou de gestion de clés API.
• Faites pivoter la clé API et le secret webhook si quelqu'un dispose d'un ancien accès à l'éditeur Wix. ne devrait plus gérer les paiements.
• Gardez le rappel URL HTTPS et public.

Dépannage

Si le fournisseur n'apparaît pas dans Accepter les paiements, confirmez que le plugin de service s'appelle MakePayPayment, que les deux fichiers du plugin existent et que le site a été publié après l'ajout du code.

Si Connect échoue, confirmez que makepay_api_key_secret existe dans Wix Secrets Manager et que l'ID de clé/ID d'entreprise API correspond à la même société MakeCrypto.

Si checkout ne redirige pas, inspectez les journaux Wix Velo pour détecter l'erreur createTransaction et confirmez que la clé API contient makepay:payment-links:write.

Si les commandes ne sont pas mises à jour, confirmez que le rappel MakeCrypto URL est https://your-wix-domain.com/_functions/makepay_notify, que le secret webhook correspond et que les journaux de livraison MakeCrypto webhook affichent une réponse 2xx.