Erreurs Courantes

​

Erreurs d’authentification

​

401 Non autorisé

• Clé API invalide
• En-tête Authorization manquant
• Utilisation d’une clé de test en production ou vice versa

// Assurez-vous d'inclure l'en-tête Authorization
const response = await fetch("https://pay.sandbox.yabetoopay.com/v1/payment-intents", {
  method: "POST",
  headers: {
    "Content-Type": "application/json",
    "Authorization": "Bearer sk_test_XXXXXXXXXXXXXXXXXXXXXXXX", // N'oubliez pas "Bearer "
  },
  body: JSON.stringify({ amount: 5000, currency: "xaf" }),
});

​

Erreurs de paiement

​

Paiement bloqué en “Processing”

• Le client n’a pas reçu la notification
• Le client n’a pas entré son PIN
• Problèmes réseau avec le fournisseur Mobile Money

1. Demandez au client de vérifier les notifications sur son téléphone
2. Assurez-vous que le numéro de téléphone est correct
3. Attendez jusqu’à 90 secondes avant le délai d’expiration
4. Permettez au client de réessayer

​

PAYEE_NOT_FOUND

• Le numéro de téléphone n’est pas enregistré chez l’opérateur Mobile Money
• Mauvais opérateur sélectionné

1. Vérifiez le format du numéro de téléphone (doit être international : +242XXXXXXXXX)
2. Confirmez que le client utilise le bon opérateur (MTN ou Airtel)
3. Demandez au client de vérifier son inscription Mobile Money

​

LOW_BALANCE_OR_PAYEE_LIMIT_REACHED_OR_NOT_ALLOWED

• Fonds insuffisants dans le compte Mobile Money
• Limite de transaction quotidienne ou mensuelle atteinte
• Transaction bloquée par l’opérateur Mobile Money

1. Affichez un message clair au client expliquant la raison de l’échec
2. Suggérez-lui de recharger son compte Mobile Money
3. Demandez-lui de vérifier ses limites de transaction avec son opérateur
4. Permettez-lui de réessayer après avoir résolu le problème

​

Problèmes de webhooks

​

Webhooks non reçus

• URL du webhook non configurée dans le tableau de bord
• Endpoint non accessible publiquement
• Pare-feu bloquant les requêtes
• Serveur retournant un statut non-200

1. Vérifiez l’URL du webhook dans le tableau de bord :
   • Allez sur app.yabetoo.com/developers
   • Vérifiez l’onglet Webhooks
   • Assurez-vous que l’URL est correcte et utilise HTTPS
2. Assurez-vous que l’endpoint est accessible :
   Copier

   curl -X POST https://votre-domaine.com/webhook/yabetoo \
     -H "Content-Type: application/json" \
     -d '{"test": true}'
   
3. Retournez un statut 200 :
   Copier

   app.post("/webhook", (req, res) => {
     // Traiter le webhook
     res.status(200).send("OK"); // Toujours retourner 200
   });
   

​

Signature webhook invalide

1. Assurez-vous d’utiliser le bon secret webhook
2. Utilisez le corps de la requête brut (pas le JSON parsé) pour la vérification de signature
3. Vérifiez que le timestamp n’est pas trop ancien

const crypto = require("crypto");

function verifyWebhook(payload, signature, timestamp, secret) {
  const signedPayload = `${timestamp}.${payload}`; // payload doit être une chaîne brute
  const expectedSig = crypto
    .createHmac("sha256", secret)
    .update(signedPayload)
    .digest("hex");

  return crypto.timingSafeEqual(
    Buffer.from(signature),
    Buffer.from(expectedSig)
  );
}

​

Problèmes de requêtes API

​

400 Bad Request

​

Délai d’expiration de la requête

1. Augmentez le timeout de votre client (recommandé : 30-60 secondes)
2. Vérifiez votre connexion réseau
3. Vérifiez que vous utilisez la bonne URL d’endpoint

​

Sandbox vs Production

​

Les paiements fonctionnent en sandbox mais pas en production

• Utilisation de la clé sk_live_ (pas sk_test_)
• Utilisation de l’URL de production : https://pay.api.yabetoopay.com
• Compte activé pour les paiements en direct
• Utilisation de vrais numéros de téléphone (pas les numéros de test)

​

Les numéros de test ne fonctionnent pas

1. Vérifiez que vous utilisez l’environnement sandbox
2. Vérifiez que vous utilisez le bon numéro de test pour le résultat souhaité
3. Consultez le guide de test pour les numéros de test valides

​

Obtenir de l’aide

1. Vérifiez la réponse de l’API - Les messages d’erreur contiennent souvent des détails utiles
2. Examinez les logs - Vérifiez les logs de votre serveur pour les erreurs
3. Testez d’abord en sandbox - Vérifiez que votre intégration fonctionne en sandbox
4. Contactez le support - Envoyez un email à [email protected] avec :
   • Votre ID de compte
   • Les détails de la requête/réponse
   • Les étapes pour reproduire le problème