FivoDocs
Docs/Démarrage rapide

Démarrage rapide

Acceptez votre premier paiement en moins de 5 minutes.

Prérequis

Un compte marchand Fivo (en créer un ici)
Votre Merchant ID (disponible dans votre tableau de bord)
Un site web ou une application où vous souhaitez accepter les paiements
1

Obtenir votre Merchant ID

Connectez-vous à votre et accédez à . Copiez votre Merchant ID.Tableau de bord Fivo et accédez à Intégration.

Votre Merchant ID ressemble à ceci :

fivo_live_969c4442-5741-4624-8305-427391683190
2

Ajouter le widget à votre site

Ajoutez la balise script suivante à votre HTML. Remplacez par votre Merchant ID réel.VOTRE_MERCHANT_ID

index.html
<!-- Fivo Payment Widget -->
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  amount="29.99"
  currency="USDC">
</fivo-button>
i

Montant fixe vs variable

L'exemple ci-dessus utilise un montant fixe (29,99 USDC). Pour les montants variables (comme les dons), supprimez simplement l'attribut amount. Consultez pour plus de détails.amount. Intégration du widget.
!

Testnet et mainnet sont des environnements separes

Le testnet utilise des fonds simules et des IDs merchant de test (fivo_test_). Le mainnet utilise des fonds reels et des IDs merchant en production (fivo_live_). Nous recommandons de valider votre integration complete sur testnet avant de passer en production.
3

Tester un paiement

Choisissez le parcours de test adapte a votre etape :

Parcours A : Testnet (recommande en premier)

Utilisez votre merchant ID fivo_test_ et du USDC de test gratuit du Circle Faucet pour valider votre integration de bout en bout sans fonds reels.

1

Obtenez du USDC de test gratuit sur le Circle Faucet a faucet.circle.com.

2

Utilisez votre merchant ID testnet (fivo_test_...) dans le code du widget.

3

Effectuez un paiement de test. Il fonctionne exactement comme en production mais avec des tokens simules.

Parcours B : Test en mainnet

Une fois votre integration validee sur testnet, testez un vrai paiement avec un montant minimal.

1

Allez dans Integration dans votre tableau de bord et cliquez sur "Essayer en direct". Il ouvre un checkout reel pre-configure a 0,01 $.

2

Connectez votre wallet et selectionnez une chaine ou vous avez du USDC ou de l'EURC.

3

Confirmez la transaction de 0,01 $. Des fonds reels seront transferes.

4

Voir dans le tableau de bord

Après que le paiement est terminé, vous le verrez dans votre page . Vous recevrez également une confirmation par e-mail.Transactions

Vous êtes prêt !

Une fois le paiement confirmé on-chain, il apparaîtra dans votre page avec l'e-mail du client. Vous et le client recevez un e-mail avec les détails de la transaction. Vos clients peuvent désormais vous payer en USDC et EURC depuis n'importe quelle blockchain supportée.Transactions

Exemples

Montant fixe : Produit ou service

Le client paie un montant exact. Idéal pour les produits, abonnements ou factures.

fixed-amount.html
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  amount="29.99"
  currency="USDC">
</fivo-button>

Cela affiche un bouton « Payer 29,99 $ en USDC » sur votre page (ou EURC si vous définissez currency="EURC"). Lorsqu'il est cliqué, le paiement Fivo s'ouvre où le client connecte son wallet, voit son solde sur chaque chaîne, sélectionne un réseau et confirme le paiement.

Montant variable : Don ou pourboire

Le client choisit le montant à payer. Supprimez simplement l'attribut amount.

donation.html
<script async src="https://checkout.fivo.finance/v1/fivo.js"></script>

<fivo-button
  merchant-id="YOUR_MERCHANT_ID"
  currency="USDC">
</fivo-button>

Cela affiche un bouton « Payer en USDC » (ou « Payer en EURC » selon votre devise configurée). Lorsqu'il est cliqué, le paiement s'ouvre et le client saisit le montant qu'il souhaite payer avant de sélectionner un réseau et de confirmer.

i

Options de devise

Vous pouvez utiliser currency="USDC" ou currency="EURC". USDC est disponible sur les 9 chaînes. EURC est disponible sur Ethereum, Avalanche et Base. Consultez pour toutes les options de configuration.Intégration du widget.

Étapes suivantes

Intégration du widget

Découvrez les montants fixes vs variables et toutes les options de configuration.

Intégration API

Créez des flux de paiement personnalisés avec notre API REST.

Inter-chaînes (Bridge Kit)

Comprenez comment les paiements inter-chaînes fonctionnent automatiquement.

Guide de test

Vérifiez votre intégration avec de vrais paiements de 0,01 $.