📊 Mise à Jour des Taux de Change (Fallback)

Dernière révision: 2026-09-08

⚠️ Important

Ce guide s'applique uniquement tant que l'API Wise n'est pas configurée.
Une fois les clés Wise obtenues, les taux seront automatiques et cette procédure devient inutile.

---

🗓️ Fréquence

Chaque lundi matin (5 minutes)

---

📝 Procédure (3 étapes)

Étape 1 : Consulter les taux réels sur Wise

⚠️ IMPORTANT : Utilisez Wise, pas XE.com !

Allez sur https://wise.com et notez les taux vers XOF :

USD → XOF = ?
CNY → XOF = ?
GBP → XOF = ?

Exemple (2 septembre 2026) :

1 USD = 566.4 XOF   (sur Wise)
1 CNY = 83.5 XOF    (sur Wise)
1 GBP = 771.2 XOF   (sur Wise)

Étape 1b : Calculer les taux EUR

Utilisez la formule :

EUR_TO_XXX = 655.957 ÷ taux XXX/XOF

Calculs (avec exemples ci-dessus) :

EUR_TO_USD = 655.957 ÷ 566.4 = 1.1581
EUR_TO_CNY = 655.957 ÷ 83.5 = 7.8558
EUR_TO_GBP = 655.957 ÷ 771.2 = 0.8505

Étape 2 : Mettre à jour le fichier

Ouvrez le fichier :

app/api/wise-quote/route.ts

Cherchez la section (ligne ~30) :

// ⚠️ TAUX FALLBACK - Mettre à jour chaque lundi
// Dernière mise à jour : 2026-09-02
// Source : https://www.xe.com
const FALLBACK_RATES = {
  EUR_TO_USD: 1.08,   // 👈 Modifier ici
  EUR_TO_CNY: 7.85,   // 👈 Modifier ici
  EUR_TO_GBP: 0.85,   // 👈 Modifier ici
};

Remplacez par les nouveaux taux calculés :

// ⚠️ TAUX FALLBACK - Mettre à jour chaque lundi
// Dernière mise à jour : 2026-09-09  👈 Nouvelle date
// Source : Wise (https://wise.com)
const FALLBACK_RATES = {
  EUR_TO_USD: 1.1581,  // 👈 Calculé : 655.957 ÷ 566.4
  EUR_TO_CNY: 7.8558,  // 👈 Calculé : 655.957 ÷ 83.5
  EUR_TO_GBP: 0.8505,  // 👈 Calculé : 655.957 ÷ 771.2
};

Étape 3 : Redémarrer le serveur

# Arrêter le serveur (Ctrl + C)
# Puis relancer :
npm run dev

✅ C'est tout ! Les nouveaux taux sont actifs.

---

🧪 Vérifier que ça marche

Allez sur : http://localhost:3000/calculator

1. Entrez 1000 USD
2. Cliquez sur "Calculer les frais"
3. Vérifiez le taux affiché :

   Taux de change : 1 USD = XXX XOF

Le taux devrait correspondre au taux Wise + 1.0% :

Taux ABP = Taux Wise × 1.01

Exemple avec Wise : 1 USD = 566.4 XOF :

566.4 × 1.01 = 572.06 XOF

C'est le taux qui doit s'afficher ! ✅

---

📌 Rappels

Taux XOF/EUR

• Taux fixe BCEAO : 655.957 XOF = 1 EUR
• ❌ Ne JAMAIS modifier ce taux (fixé par la Banque Centrale)

Marge de 1.0%

• Déjà intégrée dans le calcul
• ❌ Ne pas toucher au code de marge

Frais de transfert

• Calculés automatiquement selon le montant
• ❌ Ne pas modifier la fonction calculateFallbackFee()

---

🚀 Quand arrêter cette procédure ?

Dès que vous recevez les clés API Wise :

1. Mettez les clés dans .env.local :

   WISE_API_TOKEN=votre_vrai_token
   WISE_PROFILE_ID=votre_profile_id

2. Redémarrez le serveur

3. ✅ Les taux deviennent automatiques !

4. 🗑️ Cette procédure n'est plus nécessaire

---

💡 Astuce

Si vous oubliez de mettre à jour les taux pendant 1-2 semaines, ce n'est pas grave !

Les taux EUR/USD, EUR/CNY et EUR/GBP varient peu (généralement < 2% par mois).

L'impact sur vos devis reste minime et acceptable pour un MVP.

---

🆘 Problème ?

Si après la mise à jour les calculs semblent incorrects :

1. Vérifiez que vous avez bien redémarré le serveur
2. Videz le cache du navigateur (Cmd + Shift + R)
3. Testez avec un montant simple (ex: 1000 USD)

Si le problème persiste, vérifiez les logs du serveur :

npm run dev
# Regardez les messages ⚠️ dans le terminal

---

Questions ? Consultez docs/WISE_INTEGRATION.md