gpay_cli – Outil en ligne de commande GoalPay
ENVIRONNEMENT DE TESTOutil destiné aux développeurs pour tester l'API GoalPay en local. Ne pas utiliser en production.
Accès réservé aux comptes Marchand
Cet outil est exclusivement destiné aux comptes Marchand GoalPay disposant d'un identifiant de groupe (gid). Les comptes non-Marchand ne peuvent ni tester le CLI ni recevoir de webhooks. Si vous n'avez pas encore de compte Marchand, contactez l'équipe GoalPay pour en créer un.
Prérequis
Avant de télécharger le CLI, vérifiez que votre environnement dispose de tout le nécessaire :
| Prérequis | Windows | Linux |
|---|---|---|
| Compte GoalPay Marchand | Obligatoire (gid requis) | Obligatoire (gid requis) |
| cloudflared | À installer (section 01) | À installer (section 01) |
| Serveur local | Port libre (ex: 3001) | Port libre (ex: 3001) |
Installation de cloudflared
Le CLI utilise Cloudflare Quick Tunnel pour exposer votre serveur local sur Internet. Sans cloudflared, le CLI s'arrêtera avec le message ❌ cloudflared n'est pas installé.
Windows
# Option A — winget (si disponible)
winget install Cloudflare.cloudflared
# Option B — téléchargement manuel
# 1. Téléchargez cloudflared-windows-amd64.exe depuis :
# https://github.com/cloudflare/cloudflared/releases/latest
# 2. Renommez-le en cloudflared.exe
# 3. Placez-le dans un dossier du PATH (ex: C:\Users\<Vous>\bin\)
# ou ajoutez son dossier au PATH via les variables d'environnement.
# Vérification
cloudflared --versionLinux
# Téléchargement direct (amd64)
curl -L https://github.com/cloudflare/cloudflared/releases/latest/download/cloudflared-linux-amd64 \
-o /usr/local/bin/cloudflared
chmod +x /usr/local/bin/cloudflared
# Vérification
cloudflared --versionNote : Quick Tunnel ne nécessite aucun compte Cloudflare. L'URL trycloudflare.com générée est temporaire et change à chaque lancement. Elle est limitée à 200 requêtes simultanées et ne supporte pas les Server-Sent Events.
Téléchargement du CLI
Choisissez la version correspondant à votre système :
Windows
Fichier exécutable autonome (.exe)
Télécharger gpay_cli.exeSHA256 : a1b2c3d4... (vérifiez après téléchargement)
Lancement en 10 secondes
Il suffit d'ouvrir un terminal (PowerShell / CMD sur Windows, n'importe quel terminal sur Linux) et de taper une seule commande.
Windows
# Allez dans le dossier où vous avez téléchargé gpay_cli.exe
cd F:\Download\Project\logiciel
# Lancez avec les options pour le webhook local
.\gpay_cli.exe --gid=gid_h8cnb2HFCezEQ2Ub --port=3001 --uri=/api/webhookLinux
# Allez dans le dossier du binaire
cd ~/Downloads # ou où vous l'avez placé
# Rendez-le exécutable (une seule fois)
chmod +x gpay_cli
# Lancez
./gpay_cli --gid=gid_h8cnb2HFCezEQ2Ub --port=3001 --uri=/api/webhookComportement attendu : le CLI lance automatiquement cloudflared tunnel --url http://127.0.0.1:<port>, récupère l'URL publique, l'enregistre auprès du backend GoalPay, puis affiche un secret_key à conserver précieusement.
Recevoir les notifications (webhook) en local
Prérequis pour tester les webhooks en développement :
- •Votre serveur local doit tourner sur le port choisi (ex: 3001) et accepter les requêtes POST sur l'URI spécifiée (ex:
/api/webhook) - •cloudflared doit être installé (voir section 01) — le CLI s'occupe de créer le tunnel et de configurer le webhook côté GoalPay
- •Le
secret_keyaffiché au lancement sert à vérifier la signature des webhooks reçus