v1.0.0CLI

gpay_cli – Outil en ligne de commande GoalPay

ENVIRONNEMENT DE TEST

Outil 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.

00

Prérequis

Avant de télécharger le CLI, vérifiez que votre environnement dispose de tout le nécessaire :

PrérequisWindowsLinux
Compte GoalPay MarchandObligatoire (gid requis)Obligatoire (gid requis)
cloudflaredÀ installer (section 01)À installer (section 01)
Serveur localPort libre (ex: 3001)Port libre (ex: 3001)
01

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 --version

Linux

# 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 --version

Note : 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.

02

Téléchargement du CLI

Choisissez la version correspondant à votre système :

.exe

Windows

Fichier exécutable autonome (.exe)

Télécharger gpay_cli.exe

SHA256 : a1b2c3d4... (vérifiez après téléchargement)

bin

Linux

Binaire statique (amd64/arm64)

SHA256 : e5f6g7h8...

03

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/webhook

Linux

# 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/webhook

Comportement 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.

04

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_key affiché au lancement sert à vérifier la signature des webhooks reçus

GoalPay Madagascar – Acceptez les paiements en Ariary facilement