AshGateDocs
Support

Dépannage

Diagnostiquez et résolvez les erreurs courantes de ash-gate.

Guide de Dépannage

Codes d'erreur HTTP

CodeSignificationCause probableSolution
400Bad RequestCorps de requête mal formé ou champ manquantVérifiez le JSON envoyé
401UnauthorizedClé manquante ou invalideVérifiez X-Feda-Project-Key ou X-Feda-Project-Secret
403ForbiddenClé publique utilisée sur une route restreinteUtilisez la Secret Key côté serveur
404Not FoundProjet introuvable ou inactifVérifiez le slug/publicKey et le statut du projet
409ConflictDoublon (ex: abonnement déjà actif)L'utilisateur a déjà un abonnement actif pour ce projet
429Too Many RequestsQuota mensuel dépasséPassez au plan supérieur ou attendez le prochain cycle
500Server ErrorErreur interne ash-gateVérifiez le statut API et les logs du dashboard

Problèmes fréquents

Erreur : "Project not found" (404)

# Vérifiez que votre clé correspond bien à un projet actif
curl https://app.ashgateway.com/fedapay/transactions \
  -H "X-Feda-Project-Key: pk_sandbox_xxx"
# {"statusCode": 404, "message": "Project not found or inactive"}

Causes :

  • La publicKey est incorrecte (fautes de frappe, env sandbox vs live)
  • Le projet a été supprimé ou désactivé
  • Vous utilisez une clé live sur l'env sandbox ou vice versa
# Vérifiez vos clés dans la CLI
wallet keys list

Erreur : "This endpoint is not accessible via public project key" (403)

Vous essayez d'accéder à une route qui nécessite la Secret Key.

# Incorrect : avec une clé publique (Project Key)
curl -X POST https://app.ashgateway.com/fedapay/billing-plans \
  -H "X-Feda-Project-Key: pk_sandbox_xxx"
# → 403 Forbidden

# Correct : avec une clé secrète (Secret Key)
curl -X POST https://app.ashgateway.com/fedapay/billing-plans \
  -H "X-Feda-Project-Secret: sk_cloud_xxx"
# → 201 Created

Consultez la matrice d'accès pour savoir quelle clé utiliser.

Problème : Le widget Flutter ne s'affiche pas

Checklist :

// 1. Vérifiez que l'initialisation est faite AVANT runApp()
void main() async {
  WidgetsFlutterBinding.ensureInitialized(); // ← Ne pas oublier
  await FedaFlutter.applyCloudConfig(...);   // ← Avant runApp()
  runApp(MyApp());
}

// 2. Vérifiez votre proxyUrl (pas de slash final)
proxyUrl: 'https://app.ashgateway.com',   // Correct
proxyUrl: 'https://app.ashgateway.com/',  // Incorrect (slash final)

// 3. Ajoutez les permissions réseau (Android)
// android/app/src/main/AndroidManifest.xml
// <uses-permission android:name="android.permission.INTERNET"/>

Problème : Les webhooks ne sont pas reçus

Étapes de diagnostic :

# 1. Testez votre endpoint avec curl
curl -X POST https://mon-serveur.com/webhooks/fedapay \
  -H "Content-Type: application/json" \
  -d '{"event": "transaction.approved", "transaction": {"id": 1}}'

# 2. Vérifiez que l'URL est bien configurée côté FedaPay
#    → Dashboard FedaPay → Webhooks
#    → URL recommandée : https://app.ashgateway.com/fedapay/webhook/:projectId
#    → (Remplacez :projectId par votre ID ou Slug de projet)

# 3. Vérifiez que votre projet ash-gate a une webhookUrl configurée
wallet project list  # → voir la colonne webhookUrl

!TIP Utilisez Hoppscotch ou Webhook.site pour inspecter les payloads reçus avant d'implémenter votre handler.

Erreur : "No tenant or project owner ID" (401)

Le tenantId ne peut pas être résolu. Causes :

  1. Vous n'envoyez ni JWT ni clé de projet
  2. Le JWT a expiré
  3. La clé de projet ne correspond à aucun projet actif
# Vérifier votre token CLI
wallet auth status
# Si expiré :
wallet auth login

Activer les logs de debug

Dans votre instance ash-gate, ajoutez dans .env :

LOG_LEVEL=debug

Consultez ensuite les logs dans votre dashboard ash-gate → Projet → Logs en temps réel.

Besoin d'aide ?

  • Statut de l'API
  • 💬 Support dans votre dashboard ash-gate → Aide & Support