Prérequis:

Version Magento : 2.x

Étape 1: Créez un compte Crypto.com Pay

Créez un compte Crypto.com Pay, si vous n'en avez pas déjà un.
Allez dans l'onglet "Paramètres" sur le tableau de bord et complétez les exigences KYC.

Une fois que vous avez accès au tableau de bord pour marchand de Crypto.com Pay, vous pourrez générer une paire de clés secrètes et de clés publiables. Les clés API peuvent être trouvées dans la section Intégration > Clés API.

Remarque : vous pouvez basculer entre le bouton "Données de test du menu de gauche pour accéder aux clés API en mode réel et en mode test. Si le bouton est activé, les clés API sont en mode test. S'il est désactivé, les clés API sont en mode réel.

Étape 2: Installer le plugin sur Magento

Vous pouvez en savoir plus sur le plug-in Crypto.com Pay depuis notre répertoire GitHub et l'installer comme suit :

Téléchargez le paquet zip du module dans la page Publications.
Extrayez et importez tous les fichiers vers le chemin d'installation de Magento 2, c'est-à-dire déplacez /code/Cdcpay dans le fichier zip vers /app/code/Cdcpay sur le serveur Magento.
Connectez-vous à votre serveur, et dans le répertoire racine de votre installation, exécutez les commandes suivantes :
php bin/magento setup:upgrade
php bin/magento module:enable Cdcpay_CDCCheckout
php bin/magento setup:static-content:deploy -f
Videz vos caches de Magento2
php bin/magento cache:flush

L'installation est terminée et vous pouvez maintenant activer Crypto.com Pay dans votre boutique Magento.

Remarque : Si vous avez rencontré des erreurs telles que "La classe demandée n'a pas été générée correctement, car l'autorisation du répertoire 'generated' est en lecture seule" ou " Impossible de créer le répertoire " dans votre boutique Magento 2, cela signifie que les autorisations de fichiers dans votre environnement ne sont pas configurées correctement. Vous pouvez vous référer à la documentation de Magento pour mettre à jour les paramètres.

Étape 3: Activez Crypto.com Pay sur Magento

Connectez-vous au panneau d'administration de Magento.
Allez dans Magasins > Configuration > Ventes > Méthodes de paiement.
Naviguez vers Crypto.com Pay et développez les configurations.
Sélectionnez "Yes" dans Enabled.
Si vous souhaitez activer les transactions en mode réel sans tester le flux, vous pouvez ignorer ce qui suit et passer à l'étape 5.
Saisissez la clé secrète en mode test avec les valeurs obtenues à l'étape 1.
Sélectionnez "Oui"en mode test.
Copiez l'url du webhook dans la description du secret de signature du webhook en mode test et remplacez le [Store URL] par l'URL de votre boutique Magento.
Revenez au tableau de bord pour marchand de Crypto.com et assurez-vous que le bouton "Données de test" est activé dans le menu de gauche.
Allez dans l'onglet Intégration > Webhooks.
Cliquez sur le bouton ajouter un webhook et collez l'url du webhook copié dans URL Payload, puis un secret de signature pour le webhook sera généré.
Copiez et collez le secret de signature dans le secret de signature du webhook en mode test dans la page des paramètres de Magento.
Cliquez sur le bouton Sauvegarder la configpour enregistrer les configurations.

Remarque : veillez à configurer correctement le mode test dans le formulaire, selon que vous effectuez ou non des tests, et veillez à saisir correctement les clés secrètes, car elles sont différentes entre le mode test et le mode réel.

Étape 4: Vérifiez le flux

À ce stade, Crypto.com Pay est entièrement intégré à votre Magento. Mais il est recommandé d'essayer le flux de paiement au moins une fois.

Reportez-vous ici pour savoir comment effectuer un paiement test.

Lorsque Crypto.com Pay approuvera le paiement, la fenêtre de paiement indiquera que le paiement a été approuvé et le statut de votre commande sera également mis à jour.

Étape 5 : Configurez le compte pour les transactions en mode réel

Une fois le processus de paiement testé, vous pouvez activer les transactions en mode réel en suivant les étapes ci-dessous :

Connectez-vous au panneau d'administration de Magento, et naviguez dans Boutiques > Configuration > Ventes > Méthodes de paiement, et affichez les paramètres de Crypto.com Pay.
Sélectionnez "Non" en mode test.
Remplissez la clé secrète en mode réel avec la clé secrète du mode réel que vous avez obtenue dans le tableau de bord pour marchand.
Copiez l'url du webhook dans la description du secret de signature du webhook en mode réel et remplacez le [Store URL] par l'URL de votre boutique Magento.
Revenez au tableau de bord pour marchand de Crypto.com et assurez-vous que le bouton "Données de test" est désactivé dans le menu de gauche.
Allez dans l'onglet Intégration > Webhooks.
Cliquez sur le bouton ajouter un webhook et collez l'url du webhook copié dans URL Payload, puis un secret de signature pour le webhook sera généré.
Copiez et collez le secret de signature dans le secret de signature du webhook en mode réel dans la page des paramètres de Magento.
Cliquez sur le bouton Sauvegarder la configpour enregistrer les configurations.

Félicitations, vous pouvez désormais accepter les paiements en cryptomonnaies dans le mode réel.