Un checkout par carte à côté des paiements wallet, avec de l’USDC sur Base reçu dans le wallet de la facture.
1. Vérifie ton compte Coinflow
Utilise Wholly Crypto 9.0.0 ou plus récent. Demande à Coinflow d’approuver ton activité et d’activer le règlement en USDC sur Base vers des adresses propres à chaque facture. En production, le client doit payer les frais du prestataire, sans réserve ni retenue sur le règlement.
Disponibilité, vérification d’identité, limites et frais dépendent de ton compte Coinflow et du pays du client. Vérifie le prix final sur Coinflow avant de payer.
2. Connecte et teste en sandbox
Ouvre Settings → Fiat payments. Enregistre ton merchant ID Coinflow, ton API key et ta Webhook Validation Key. Ajoute l’URL de callback affichée dans Coinflow, puis vérifie la connexion. Garde les identifiants côté serveur ; ne partage jamais les clés des wallets.
Le checkout sandbox de l’admin est un test séparé de 10 USD avec une adresse sandbox. Il ne paie pas de facture de production. Une connexion réussie ne confirme pas à elle seule l’éligibilité de ton activité ou du paiement.
3. Active l’USDC sur Base dans ta boutique
Sauvegarde le wallet du projet et vérifie le scanner Base. Dans Store → Payment methods, accepte l’USDC natif sur Base et active les cartes. Utilise USDC, pas USDbC ni USDC sur Ethereum. Une facture sans USDC sur Base ne propose pas la carte.
4. Teste un petit paiement réel
Après l’accord de Coinflow, active la production et crée une facture normale à la main ou via l’API. Choisis la carte au checkout. La facture garde sa monnaie, son devis et sa marge ; Coinflow montre au client les frais finaux et la conversion avant le paiement.
5. Vérifie la réception avant de livrer
Une facture est réglée seulement quand son USDC arrive et respecte ta politique de confirmations blockchain. Une autorisation de carte ou un retour au checkout ne prouve pas le paiement.
Consulte les détails Card payment de la facture et la transaction USDC sur Base. Garde ton flux habituel avec IPN ou webhooks signés. Agis sur invoice.settled et vérifie requires_review ; ne livre jamais sur le seul retour du navigateur. Les paiements tardifs ou contradictoires peuvent demander une vérification.
6. Transfère les fonds et gère les exceptions
Garde de l’ETH sur Base pour envoyer l’USDC reçu vers ton cold wallet, ou configure l’approvisionnement en gas et les sweeps automatiques. Gère les remboursements carte et contestations dans Coinflow. Ne rembourse jamais de cryptos à l’expéditeur de la transaction du prestataire. Examine les litiges dans Needs attention.