Plugins e-commerce
Passerelle WISECP
Installez et configurez la passerelle officielle WISECP pour le paiement hébergé MakePay sur les factures d'hébergement et de service.
Passerelle MakePay WISECP
La passerelle officielle MakePay WISECP permet aux clients de payer leurs factures via la crypto hébergée checkout. WISECP garde le contrôle des clients, des factures, des services, des renouvellements et de l'approvisionnement. MakePay crée le lien checkout et renvoie les mises à jour de paiement à WISECP.
Ceci est utile pour les fournisseurs d'hébergement, les équipes SaaS, les agences et les entreprises de services qui gèrent déjà la facturation via WISECP.
Avant de commencer
Il vous faut :
- WISECP 3.1.7 ou version ultérieure
- Installation HTTPS WISECP
- Accès administrateur aux paramètres de la passerelle de paiement WISECP
- Règlement MakePay et personnalisation configurés
Installer la passerelle
Téléchargez le dernier package :
https://plugins.makecrypto.io/downloads/wisecp/latest.zip
Extrayez le ZIP et téléchargez le dossier MakePay vers :
WISECP/coremio/modules/Payment/MakePay
Dans WISECP, ouvrez Paramètres > Facturation > Passerelles de paiement, recherchez MakePay, activez-le et enregistrez les paramètres du module.
Connectez MakePay
Ouvrez les paramètres de la passerelle MakePay dans WISECP et utilisez le lien Connecter MakePay affiché dans le champ d'état de la connexion.
Le flux de connexion :
- Ouvre la page de connexion du MakePay.
- Vous permet de choisir l'entreprise qui doit recevoir les paiements.
- Vous renvoie à WISECP après approbation.
- Enregistre la connexion à la passerelle pour cette installation WISECP.
Après vous être connecté, créez une petite facture test et payez-la depuis l'espace client.
Manuel de secours de la clé API
Connect MakePay est la configuration recommandée. La configuration manuelle par clé API est disponible pour les installations qui ne peuvent pas effectuer la connexion guidée.
Pour une configuration manuelle, définissez la méthode de connexion sur api_key et saisissez :
- ID d'entreprise MakePay
- ID de clé API
- Clé secrète API
- Secret de signature Webhook
Gardez le rappel URL généré par WISECP accessible depuis l'Internet public.
Flux de paiement
Lorsqu'un client choisit MakePay pour une facture WISECP, la passerelle :
- Lit l'ID checkout, le montant de la facture et la devise du WISECP.
- Crée un lien de paiement MakePay hébergé.
- Affiche un bouton Payer avec MakePay.
- Envoie le client vers checkout hébergé.
- Reçoit un rappel signé lorsque le statut du paiement change.
Le lien de paiement comprend des métadonnées telles que :
| Champ | But |
|---|---|
source=wisecp | Identifie l'intégration |
checkoutId | Mappe l’activité du MakePay au WISECP checkout |
orderId | Utilise l'ID WISECP checkout pour la recherche de rappel |
États de facture
| Statut MakePay | Comportement du WISECP |
|---|---|
paid, completed, confirmed, succeeded | Marque le succès du checkout |
pending, waiting, confirming | Maintient le checkout en attente |
failed, expired, cancelled | Marque le checkout comme erreur |
WISECP reste responsable de l'activation du service, des renouvellements, de la numérotation des factures et des notifications client après le paiement de la facture.
Notes de sécurité
Utilisez HTTPS, limitez l'accès de l'administrateur au WISECP et déconnectez la passerelle du tableau de bord MakePay si un compte d'administrateur ou une sauvegarde de serveur est exposé. Reconnectez-vous après avoir modifié le domaine WISECP afin que les URL de rappel et de retour correspondent à l'installation en direct.
Dépannage
Si Connect MakePay ne peut pas démarrer, confirmez que la passerelle est installée sous coremio/modules/Payment/MakePay et que le rappel WISECP URL est public.
Si les factures ne sont pas mises à jour, vérifiez que le secret de signature webhook est présent et que votre serveur peut recevoir des rappels HTTPS de MakePay.
Si les clients voient une erreur checkout, confirmez que MakePay est connecté et que la devise de facturation sélectionnée est prise en charge par votre configuration MakePay.