CLI ashgate

La CLI ashgate (ashgate-cli) est l'outil en ligne de commande officiel de l'écosystème AshGateway. Elle permet d'automatiser l'authentification Keycloak SSO, d'initialiser le code de paiement pour vos projets web (Nuxt, Vue, Next, React, Flutter), de tester des paiements en direct depuis le terminal et de diagnostiquer l'état de l'infrastructure.

---

Installation Rapide (One-Liner)

Télécharge et installe automatiquement le binaire natif autonome directement depuis notre infrastructure (sans dépendance Node.js) :

curl -fsSL https://ashgateway.com/install.sh | bash

Ou alternativement depuis le sous-domaine API :

curl -fsSL https://api.ashgateway.com/install.sh | bash

Vérifiez que l'installation a réussi :

ashgate doctor

---

Authentification (ashgate auth)

L'authentification s'appuie sur le SSO Keycloak en utilisant le protocole OAuth2 / OIDC avec le flux d'autorisation PKCE.

Connexion

Ouvre automatiquement votre navigateur web pour vous connecter de manière sécurisée :

ashgate auth login

Déconnexion

Supprime les jetons d'accès stockés localement :

ashgate auth logout

Statut de session

Affiche l'état de la connexion courante, l'email de l'utilisateur et la durée de session restante :

ashgate status

---

Diagnostic Système (ashgate doctor)

Exécute un bilan de santé complet de votre environnement local et teste la connectivité aux API AshGateway et Keycloak SSO :

ashgate doctor

---

Tester un Paiement en Direct (ashgate pay)

Permet d'initier un paiement de test directement depuis le terminal. Génère un lien de paiement et un QR Code scannable dans la console :

# Paiement Mobile Money par défaut
ashgate pay --amount 5000 --currency XOF --email [email protected] --provider fedapay

# Paiement FeexPay avec ouverture automatique du navigateur
ashgate pay -a 6500 -e [email protected] --provider feexpay --open

# Paiement Stripe par carte bancaire
ashgate pay -a 9.99 -c EUR --provider stripe

---

Initialisation du Projet Local (ashgate init)

La commande init détecte le framework de votre projet local (Nuxt 3, Vue 3, Next.js, React, Flutter), installe les dépendances requises, configure les clés d'API et génère le code d'intégration de paiement prêt à l'emploi.

ashgate init

Fonctionnalités de génération par Framework :

• Nuxt 3 : Génère la route serveur Nitro server/api/ashgate/checkout.post.ts, le composable composables/useAshgatePayment.ts et le composant components/AshgateCheckout.vue.
• Next.js : Génère l'API Route App Router app/api/ashgate/checkout/route.ts, le React Hook hooks/useAshgatePayment.ts et le composant components/AshgateCheckout.tsx.
• Vue 3 (Vite) : Génère le composable src/composables/useAshgatePayment.js et le composant Vue.
• React (Vite) : Génère le React Hook src/hooks/useAshgatePayment.ts et le composant.
• Flutter : Génère lib/ashgate_payment.dart, les adaptateurs de passerelles et l'application d'exemple dans lib/main.dart.

---

Gestion de Projets (ashgate project)

Permet de lister, créer, inspecter et suivre l'utilisation de vos projets de paiement depuis le terminal.

Lister vos projets

ashgate project list

Créer un nouveau projet

ashgate project create \
  --name "Mon Application" \
  --slug "mon-app" \
  --sandbox-key "sk_sandbox_xxxx" \
  --feexpay-key "feexpay_api_key_xxxx" \
  --feexpay-shop "shop_id_xxxx"

---

Désinstallation (ashgate uninstall)

Supprime proprement le binaire ashgate ainsi que tous les jetons et configurations locales :

ashgate uninstall