Passerelle MakePay Blesta

La passerelle officielle MakePay Blesta permet aux clients de payer les factures Blesta via la crypto hébergée checkout. Blesta crée et est propriétaire de la facture. MakePay crée le lien checkout et renvoie les mises à jour de paiement à Blesta.

La facturation récurrente reste dans Blesta. Lorsque Blesta crée une facture de renouvellement, la passerelle la traite comme n'importe quel autre paiement de facture.

Avant de commencer

Il vous faut :

• Blesta 5.x ou version ultérieure
• Installation HTTPS Blesta
• Accès administrateur aux passerelles de paiement Blesta
• Règlement MakePay et personnalisation configurés

Installer la passerelle

Téléchargez le dernier package :

https://plugins.makecrypto.io/downloads/blesta/latest.zip

Extrayez le ZIP et téléchargez le dossier makepay vers :

Blesta/components/gateways/nonmerchant/makepay

Dans Blesta, ouvrez Paramètres > Passerelles de paiement, choisissez Disponible, recherchez MakePay et installez-le en tant que passerelle non merchant.

Connectez MakePay

Ouvrez les paramètres de la passerelle MakePay dans Blesta et cliquez sur Connecter MakePay.

Le flux de connexion :

1. Ouvre la page de connexion du MakePay.
2. Vous permet de choisir l'entreprise qui doit recevoir les paiements.
3. Vous renvoie à Blesta après approbation.
4. Enregistre la connexion à la passerelle pour cette installation Blesta.

Après vous être connecté, créez une petite facture test et payez-la depuis l'espace client.

Manuel de repli de la clé API

Connect MakePay est la configuration recommandée. La configuration manuelle de la clé API est disponible pour les magasins qui ne peuvent pas effectuer la connexion guidée.

Pour une configuration manuelle, définissez la méthode de connexion sur Clé manuelle API et saisissez :

• ID d'entreprise MakePay
• ID de clé API
• Clé secrète API
• Secret de signature Webhook

Gardez le rappel URL affiché dans Blesta accessible depuis l'Internet public.

Flux de paiement

Lorsqu'un client choisit MakePay pour une facture Blesta, la passerelle :

1. Lit le montant de la facture, la devise, l'ID client et les métadonnées de la facture.
2. Crée un lien de paiement MakePay hébergé.
3. Affiche un bouton Payer avec MakePay.
4. Envoie le client vers checkout hébergé.
5. 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=blesta	Identifie l'intégration
orderId=blesta_invoice_<invoiceId>	Mappe l’activité du MakePay vers le Blesta
invoiceId	ID de facture principal Blesta
clientId	ID client Blesta lorsqu'il est disponible

États de facture

Statut MakePay	Comportement du Blesta
paid, completed, confirmed, succeeded	Enregistre une transaction approuvée
pending, waiting, confirming	Maintient le paiement en attente
failed, expired, cancelled	Enregistre un paiement refusé

Blesta reste responsable de l'activation du service et de l'automatisation de la facturation récurrente après le paiement de la facture.

Notes de sécurité

Utilisez HTTPS, limitez l'accès de l'administrateur au Blesta 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 Blesta 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 le rappel Blesta URL est public et que la passerelle est installée en tant que passerelle non merchant.

Si les factures ne se mettent pas à jour, vérifiez que le rappel URL affiché dans les paramètres est joignable et que le secret de signature webhook est présent.

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.