FivoDocs
Docs/Tests

Tests

Vérifiez votre intégration avec de vrais micro-paiements avant la mise en production.

Comment fonctionnent les tests

Fivo traite de vrais paiements sur mainnet. Pour tester votre intégration, utilisez le bouton dans votre page . Il ouvre un vrai paiement pré-configuré à 0,01 $ USDC ou EURC utilisant votre Merchant ID.Essayer en directIntegration

i

Vrais paiements, coût minimal

Chaque test coûte 0,01 $ plus un petit frais de gas (coût de transaction réseau). C'est le moyen le plus sûr de confirmer que tout fonctionne de bout en bout avant d'accepter des paiements plus importants.

Utiliser « Essayer en direct »

1

Ouvrir la page Intégration

Allez dans dans votre tableau de bord et cliquez sur le bouton .IntegrationEssayer en direct

2

Connecter votre wallet

Connectez MetaMask, Coinbase Wallet ou tout wallet compatible WalletConnect. Assurez-vous qu'il contient des USDC ou EURC.

3

Effectuer le paiement de 0,01 $

Sélectionnez une chaîne où vous avez des USDC ou EURC et confirmez la transaction.

4

Vérifier le résultat

Consultez votre page pour le nouveau paiement et confirmez que vous avez reçu la notification par e-mail.Transactions

Que tester

Nous recommandons de vérifier ces scénarios :

Paiement sur la même chaîne

Payez depuis la même blockchain que votre wallet marchand. C'est le flux le plus rapide. Le transfert est instantané.

Paiement inter-chaînes (USDC uniquement)

Payez depuis une chaîne différente de celle de votre wallet marchand. Bridge Kit transfère automatiquement les USDC via CCTP vers votre chaîne (généralement 1 à 2 minutes). Remarque : EURC ne supporte pas l'inter-chaînes : il fonctionne uniquement sur la même chaîne.

Solde insuffisant

Essayez de payer depuis une chaîne où vous n'avez pas assez de fonds. Le widget devrait afficher un badge « Insuffisant » sur cette chaîne et empêcher la sélection.

Rejet de transaction

Cliquez sur « Payer » puis rejetez la transaction dans votre wallet. Le widget devrait afficher une erreur et vous permettre de réessayer.

Checklist pré-lancement

Avant d'annoncer votre intégration, vérifiez ces éléments :

Débogage

Si quelque chose ne fonctionne pas, vérifiez ces problèmes courants :

Le widget ne se charge pas

  • Vérifiez la console du navigateur pour les erreurs
  • Vérifiez que l'URL du script est correcte : checkout.fivo.finance/v1/fivo.js
  • Assurez-vous que est un identifiant valide (format : )merchant-id (fivo_live_UUID)

Aucun solde affiché

  • Assurez-vous que votre wallet contient des USDC ou EURC sur une chaîne supportée
  • Attendez quelques secondes que le scan des soldes se termine
  • Vérifiez que votre wallet est connecté

La transaction échoue

  • Assurez-vous d'avoir suffisamment de tokens natifs pour le gas (ETH, MATIC, AVAX, etc.)
  • Vérifiez que vous avez suffisamment de USDC ou EURC pour le montant du paiement
  • Essayez de rafraîchir la page et de reconnecter votre wallet

Le paiement inter-chaînes est en attente

  • Les transferts inter-chaînes CCTP prennent généralement 1 à 2 minutes
  • En période de congestion réseau, cela peut prendre plus longtemps
  • Vérifiez le statut du paiement dans votre page Transactions

Journaux de la console

Le widget enregistre des informations utiles dans la console du navigateur (appuyez sur F12 pour ouvrir). Recherchez les messages commençant par :[Fivo Widget]:

Browser Console
[Fivo Widget] Configuration loaded: {merchantId: "fivo_live_...", amount: "29.99", currency: "USDC", mode: "fixed"}
[Fivo Widget] Using URL/default config: {merchantId: "fivo_live_...", amount: "0.01", currency: "USDC"}

Si vous voyez des messages d'erreur comme , vérifiez que votre Merchant ID respecte le format .Invalid Merchant ID format, fivo_live_UUID.

Besoin d'aide ?

Si vous êtes bloqué ou avez trouvé un bug, nous sommes là pour vous aider.

Contacter le support