Coinbase Commerce sur Shopify en 15 min

Points clés

Coinbase Commerce facture 1 % par transaction sans abonnement mensuel (source : Coinbase Commerce docs 2026), ce qui en fait l'une des passerelles crypto les plus accessibles pour les e-commerçants débutants comme confirmés.
Shopify dépasse 4,6 millions de boutiques actives dans le monde en 2026 (source : BuiltWith) et propose désormais une intégration native avec Coinbase Commerce via son système de providers de paiement tiers — plus besoin de plugin externe.
WooCommerce détient 36 % de parts de marché e-commerce mondial, soit environ 6,5 millions de sites actifs (source : BuiltWith 2026), et reste la plateforme où l'intégration Coinbase Commerce offre le plus de flexibilité grâce au plugin officiel ou à l'API directe.
Les paiements marchands en crypto ont augmenté de 70 % entre 2023 et 2025 selon Chainalysis, portés par la démocratisation des stablecoins comme l'USDC et la réduction des frais sur les réseaux Layer 2 comme Base.
Coinbase Commerce supporte plus de 10 cryptomonnaies dont BTC, ETH, USDC et DOGE sur les réseaux Base, Ethereum et Polygon (source : Coinbase 2026), avec un settlement en crypto uniquement — la conversion fiat passe par un compte Coinbase séparé.

Coinbase Commerce en 2026 : ce qui a changé

Coinbase Commerce n'est plus le même outil qu'à son lancement en 2018. La version actuelle, parfois appelée "Commerce 2.0", a abandonné l'ancienne architecture de charges au profit d'un système basé sur les checkouts Coinbase Onramp. Concrètement, le client scanne un QR code ou clique sur un lien de paiement, et la transaction passe par le réseau Coinbase.

Le changement majeur en 2026-2026 concerne le réseau Base, le Layer 2 d'Ethereum développé par Coinbase. Les paiements en USDC sur Base coûtent désormais quelques centimes de frais réseau, contre plusieurs dollars sur Ethereum mainnet. Pour un e-commerçant qui vend des produits à 30 ou 50 €, cette différence est décisive.

Autre évolution : l'entrée en vigueur du règlement MiCA en Europe a clarifié le statut des prestataires de services sur actifs numériques (CASP). Coinbase a obtenu son enregistrement en tant que CASP dans plusieurs pays européens, ce qui sécurise juridiquement l'utilisation de Coinbase Commerce par les marchands français. L'AMF supervise désormais les CASP opérant en France sous le cadre harmonisé MiCA.

Côté concurrence, Coinbase Commerce fait face à BitPay, NOWPayments et même Stripe, qui a réintégré les paiements crypto via USDC en 2024. Mais le positionnement reste distinct : 1 % de frais tout compris, pas d'abonnement, et une intégration directe dans l'écosystème Coinbase pour la gestion des fonds.

Prérequis avant l'installation

Compte Coinbase Commerce et clés API

Avant de toucher à Shopify ou WooCommerce, il faut un compte Coinbase Commerce actif. Depuis 2025, Coinbase Commerce est rattaché à un compte Coinbase standard — il n'existe plus de compte Commerce séparé.

Créer un compte sur commerce.coinbase.com
Lier ce compte à un compte Coinbase vérifié (identité, adresse)
Générer une clé API dans le tableau de bord Commerce, section "Developer settings"
Noter le Shared Secret pour les webhooks — indispensable pour la vérification des callbacks

La clé API Coinbase Commerce permet à votre boutique de créer des charges (demandes de paiement) et de vérifier leur statut. Le Shared Secret sert à authentifier les notifications envoyées par Coinbase vers votre serveur.

Vérification KYB et conformité MiCA

Pour les entreprises européennes, Coinbase exige une vérification KYB (Know Your Business) depuis l'application du règlement MiCA. Il faut fournir :

Extrait Kbis de moins de 3 mois (ou équivalent européen)
Pièce d'identité du dirigeant
Justificatif de domicile du siège social
Déclaration de l'activité commerciale

Le délai de validation varie de 48 heures à deux semaines. En France, l'AMF peut demander des vérifications complémentaires pour les marchands dont le volume dépasse certains seuils. Anticipez cette étape — elle bloque l'activation des paiements réels.

Installer Coinbase Commerce sur Shopify

Activer le provider de paiement natif

Shopify a intégré Coinbase Commerce dans sa liste de providers de paiement alternatifs. L'installation ne nécessite plus de passer par une app tierce.

Depuis l'admin Shopify, aller dans Paramètres > Paiements
Dans la section "Modes de paiement alternatifs", cliquer sur Ajouter un mode de paiement
Rechercher "Coinbase Commerce" dans la liste des providers
Entrer la clé API générée dans le tableau de bord Coinbase Commerce
Sélectionner les cryptomonnaies que vous souhaitez accepter (BTC, ETH, USDC, DOGE, etc.)
Sauvegarder

L'avantage de cette intégration native : les commandes payées en crypto apparaissent dans le même tableau de bord que les commandes Stripe ou PayPal. Le statut de paiement se synchronise automatiquement via les webhooks.

Configurer les webhooks Shopify

Les webhooks sont le mécanisme par lequel Coinbase Commerce informe votre boutique qu'un paiement a été confirmé, expiré ou échoué.

Dans le tableau de bord Coinbase Commerce, aller dans Settings > Webhooks
Ajouter l'URL de webhook Shopify : elle suit le format https://votre-boutique.myshopify.com/services/coinbase-commerce/webhooks
Coller le Shared Secret dans le champ correspondant côté Shopify
Tester la connexion avec le bouton "Send test webhook"

Si le test renvoie un code 200, la connexion fonctionne. Un code 4xx ou 5xx indique un problème de pare-feu, de certificat SSL ou d'URL incorrecte.

Tester une commande en mode sandbox

Coinbase Commerce ne propose pas de mode sandbox à proprement parler, contrairement à Stripe. La méthode recommandée :

Créer un produit test à 1 $ / 1 €
Passer une commande réelle en payant en USDC sur Base (frais réseau inférieurs à 0,01 $)
Vérifier que le webhook déclenche bien la mise à jour du statut de commande dans Shopify
Procéder à un remboursement manuel via le tableau de bord Coinbase si nécessaire

Cette étape est non négociable. Un webhook mal configuré signifie des commandes marquées "en attente" indéfiniment, des clients frustrés et du support inutile.

Installer Coinbase Commerce sur WooCommerce

Plugin officiel vs intégration API directe

Deux options existent pour WooCommerce, et le choix dépend de votre profil technique.

Le plugin officiel Coinbase Commerce (disponible sur le répertoire WordPress) convient à 90 % des cas. Il ajoute une passerelle de paiement dans WooCommerce, gère les webhooks automatiquement et ne nécessite aucune ligne de code.

L'intégration API directe s'adresse aux développeurs qui veulent un contrôle total : checkout personnalisé, gestion fine des confirmations, intégration avec un ERP ou un système de facturation sur mesure. Elle implique d'utiliser l'API REST Coinbase Commerce pour créer des charges, écouter les événements webhook et gérer les statuts manuellement.

Pour la majorité des e-commerçants, le plugin suffit. Passez à l'API uniquement si vous avez un besoin spécifique que le plugin ne couvre pas — comme la gestion d'abonnements récurrents ou un tunnel d'achat entièrement custom.

Réglages WordPress et WooCommerce étape par étape

1. Installer le plugin

Depuis l'admin WordPress : Extensions > Ajouter > Rechercher "Coinbase Commerce". Installer et activer le plugin développé par Coinbase, Inc. Vérifiez que votre version de WooCommerce est 8.0 ou supérieure et que PHP tourne en 8.1 minimum.

2. Configurer la passerelle

Aller dans WooCommerce > Réglages > Paiements. La passerelle "Coinbase Commerce" apparaît dans la liste. Cliquer sur Gérer puis renseigner :

Clé API : celle générée dans le dashboard Coinbase Commerce
Shared Secret : pour la vérification des webhooks
Titre affiché : par exemple "Payer en Bitcoin, ETH ou USDC"
Description : un court texte expliquant le processus au client

3. Configurer le HTTPS

Coinbase Commerce exige une connexion HTTPS. Si votre site WordPress n'est pas encore en SSL, installez un certificat via Let's Encrypt (gratuit) ou votre hébergeur. Sans HTTPS, les webhooks seront rejetés systématiquement.

4. Vérifier les permaliens

Les webhooks WooCommerce dépendent de la structure des permaliens. Allez dans Réglages > Permaliens et assurez-vous de ne pas être en mode "Simple". Le mode "Nom de l'article" ou toute structure personnalisée fonctionne.

Configurer les webhooks WooCommerce

Le plugin crée automatiquement un endpoint webhook à l'adresse : https://votre-site.com/?wc-api=coinbase_commerce

Copier cette URL
L'ajouter dans le tableau de bord Coinbase Commerce sous Settings > Webhooks
Renseigner le Shared Secret correspondant
Envoyer un test webhook depuis Coinbase Commerce
Vérifier dans les logs WooCommerce (WooCommerce > État > Journaux) que le webhook a été reçu et traité

Si vous utilisez un plugin de cache (WP Rocket, W3 Total Cache), excluez l'URL du webhook du cache. Un webhook mis en cache renvoie une réponse obsolète et Coinbase Commerce considère la livraison comme échouée.

Tester le checkout crypto de bout en bout

Même approche que sur Shopify, adaptée à WooCommerce :

Créer un produit test "Paiement crypto test" à 1 €
Ajouter au panier, passer commande, sélectionner "Coinbase Commerce"
Le client est redirigé vers la page de paiement Coinbase — vérifier que le montant et la devise sont corrects
Payer en USDC sur Base pour minimiser les frais
Après confirmation on-chain (quelques secondes sur Base), vérifier que la commande passe en statut "En cours" ou "Terminée" dans WooCommerce
Contrôler le tableau de bord Coinbase Commerce : le paiement doit apparaître avec le hash de transaction

Gérer la réception des paiements

Settlement en crypto vs conversion fiat automatique

Coinbase Commerce effectue le settlement uniquement en cryptomonnaie. Quand un client paie en BTC, vous recevez du BTC. Quand il paie en USDC, vous recevez de l'USDC.

Pour convertir en euros, deux options :

Manuelle : transférer les fonds vers votre compte Coinbase, convertir en EUR, puis virer vers votre compte bancaire via SEPA. Délai : 1-3 jours ouvrés.
Semi-automatique : configurer des règles de conversion automatique dans Coinbase. Chaque paiement reçu est converti immédiatement en EUR au taux du marché. Coinbase applique un spread de 0,5 % à 1,5 % en plus des frais Commerce.

Si vous préférez le settlement fiat direct sans passer par Coinbase manuellement, BitPay ou Stripe (USDC) proposent cette fonctionnalité nativement. C'est une limite réelle de Coinbase Commerce par rapport à ses concurrents.

Comptabilité et TVA sur les paiements crypto

En France, un paiement reçu en crypto doit être comptabilisé en euros au cours du jour de la transaction. L'administration fiscale ne fait pas de distinction entre un paiement en carte bancaire et un paiement en Bitcoin : la TVA s'applique de la même manière.

Points de vigilance :

Taux de change : utiliser le cours au moment exact de la transaction (Coinbase Commerce fournit ce taux dans les détails de chaque charge)
Écritures comptables : le paiement crypto constitue un actif numérique au bilan. La conversion ultérieure en euros peut générer une plus-value ou moins-value imposable
Factures : mentionner le montant en euros, pas en crypto, conformément aux règles de facturation françaises

Un expert-comptable familiarisé avec les actifs numériques est quasi indispensable dès que le volume dépasse quelques transactions par mois. Des outils comme Cryptio ou Bitwave peuvent automatiser le rapprochement comptable entre Coinbase Commerce et votre logiciel de comptabilité.

Optimiser le taux de conversion au checkout

Réduire les abandons de panier crypto

Le paiement crypto souffre d'un taux d'abandon plus élevé que la carte bancaire. Les causes principales : temps de confirmation blockchain, complexité perçue, et incertitude sur les frais réseau.

Quelques leviers concrets :

Privilégier les paiements sur Base ou Polygon : confirmation en secondes, frais négligeables. Mettez ces réseaux en avant dans l'interface de checkout.
Indiquer clairement le délai : "Paiement confirmé en moins de 30 secondes sur le réseau Base" rassure le client.
Proposer USDC en premier : pas de volatilité, pas de surprise de montant entre le moment du clic et la confirmation.
Timer visible : Coinbase Commerce donne 60 minutes pour compléter un paiement. Affichez ce countdown pour créer de l'urgence.

Afficher les cryptos acceptées sur les fiches produit

Un badge "Bitcoin accepté" ou "Payer en crypto" sur les fiches produit et la page d'accueil attire une clientèle spécifique. Selon une étude PYMNTS/BitPay de 2024, 40 % des clients crypto déclarent choisir un marchand plutôt qu'un autre en fonction de l'acceptation des cryptomonnaies.

Sur Shopify, ajoutez un badge via le personnalisateur de thème ou une app de badges. Sur WooCommerce, un simple shortcode ou un widget dans la sidebar suffit. Coinbase Commerce fournit des assets graphiques (logos des cryptos acceptées) téléchargeables depuis le dashboard.

Problèmes fréquents et dépannage

Paiement marqué pending : que faire

Un paiement "pending" signifie que la transaction a été détectée sur la blockchain mais n'a pas atteint le nombre de confirmations requis. Sur Bitcoin, Coinbase Commerce exige 3 confirmations (environ 30 minutes). Sur Ethereum mainnet, 12 confirmations. Sur Base, quelques secondes suffisent généralement.

Actions à prendre :

Vérifier le hash de transaction dans un explorateur blockchain (Blockchair pour BTC, Etherscan pour ETH, Basescan pour Base)
Si la transaction est confirmée mais le statut reste "pending" dans votre boutique, le webhook a probablement échoué — relancer manuellement depuis le dashboard Coinbase Commerce
Si la transaction est réellement en attente (mempool congestionné sur Bitcoin), patience. Ne marquez pas la commande comme payée manuellement avant confirmation

Conflits de plugins WooCommerce courants

Les conflits de plugins sont la première cause de dysfonctionnement de Coinbase Commerce sur WooCommerce. Les coupables récurrents :

Plugins de cache (WP Rocket, LiteSpeed Cache) : mettent en cache les endpoints webhook. Solution : exclure /?wc-api=coinbase_commerce du cache.
Plugins de sécurité (Wordfence, Sucuri) : bloquent les requêtes POST entrantes de Coinbase Commerce. Solution : whitelister les IP de Coinbase dans les règles de pare-feu.
Plugins de redirection HTTPS : peuvent interférer avec les callbacks. Solution : vérifier que le site force le HTTPS partout, sans boucle de redirection.
WooCommerce Subscriptions : le plugin Coinbase Commerce standard ne gère pas les abonnements récurrents. Pour les paiements récurrents, il faut passer par l'API et un développement custom, ou utiliser un protocole de streaming comme Superfluid.

En cas de doute, désactivez tous les plugins sauf WooCommerce et Coinbase Commerce, testez, puis réactivez un par un pour isoler le conflit.

Shopify vs WooCommerce : quelle intégration choisir

Le choix ne dépend pas de Coinbase Commerce lui-même — l'outil fonctionne bien sur les deux plateformes. Il dépend de votre contexte technique et commercial.

Shopify convient si vous voulez une installation en 10 minutes sans toucher au code, un hébergement géré et une maintenance zéro côté serveur. L'inconvénient : moins de personnalisation du tunnel de paiement, et Shopify prélève sa propre commission en plus du 1 % Coinbase Commerce si vous n'utilisez pas Shopify Payments comme passerelle principale.

WooCommerce convient si vous avez besoin d'un contrôle total, d'un checkout personnalisé, d'une intégration ERP, ou si vous refusez de dépendre d'une plateforme SaaS propriétaire. L'inconvénient : vous gérez l'hébergement, les mises à jour WordPress, la sécurité SSL, et les conflits de plugins.

En termes de fiabilité des webhooks, Shopify a l'avantage : infrastructure managée, pas de plugin de cache à configurer, pas de pare-feu à whitelister. Sur WooCommerce, chaque hébergeur a ses particularités et les webhooks sont la première source de problèmes.

Pour un marchand qui démarre avec les paiements crypto et veut tester sans friction, Shopify est le choix pragmatique. Pour un marchand technique qui vend déjà sur WooCommerce, migrer vers Shopify juste pour Coinbase Commerce n'a aucun sens — le plugin WooCommerce fait le travail.

Questions fréquentes

Est-ce que Coinbase Commerce fonctionne avec tous les thèmes Shopify ou faut-il un thème spécifique ?

Coinbase Commerce fonctionne avec tous les thèmes Shopify sans exception. L'intégration passe par le système de providers de paiement natif de Shopify, qui est indépendant du thème. Le client est redirigé vers une page de paiement hébergée par Coinbase, donc aucune modification de template n'est nécessaire.

Comment recevoir mes paiements Coinbase Commerce directement en euros sur mon compte bancaire ?

Coinbase Commerce ne propose pas de settlement fiat direct. Pour recevoir des euros, il faut transférer les cryptos reçues vers un compte Coinbase, les convertir en EUR, puis effectuer un virement SEPA vers votre banque. Vous pouvez configurer des conversions automatiques dans Coinbase pour réduire la manipulation manuelle. Si le settlement fiat natif est un critère décisif, BitPay ou Stripe proposent cette fonctionnalité.

Est-ce que je dois déclarer la TVA différemment si j'accepte les paiements en Bitcoin sur WooCommerce ?

Non, la TVA s'applique exactement de la même façon qu'un paiement classique. Le montant de la transaction doit être enregistré en euros au cours du jour, et la TVA calculée sur ce montant en euros. La seule spécificité concerne la comptabilisation de l'actif numérique reçu et l'éventuelle plus-value ou moins-value lors de sa conversion ultérieure en fiat.

Coinbase Commerce est-il compatible avec WooCommerce Subscriptions ?

Le plugin officiel Coinbase Commerce pour WooCommerce ne gère pas les paiements récurrents automatiques. Les cryptomonnaies fonctionnent en mode "push" (le client initie chaque paiement), contrairement aux prélèvements bancaires. Pour des abonnements, il faudrait développer une intégration custom via l'API Coinbase Commerce qui envoie une demande de paiement à chaque échéance, ou utiliser un protocole spécialisé comme Superfluid pour le streaming de paiements en USDC.

Est-ce que Coinbase Commerce fonctionne en France avec la réglementation MiCA en 2026 ?

Oui, Coinbase a obtenu son enregistrement en tant que CASP (Crypto-Asset Service Provider) sous le règlement MiCA, ce qui couvre ses activités dans l'ensemble de l'Union européenne, France incluse. L'AMF supervise les CASP opérant sur le territoire français. Les marchands français peuvent utiliser Coinbase Commerce légalement, à condition de respecter leurs propres obligations fiscales et comptables liées à l'acceptation de paiements en actifs numériques.

Quelle est la différence entre le plugin Coinbase Commerce pour WooCommerce et l'intégration par API ?

Le plugin officiel s'installe en quelques clics, gère les webhooks automatiquement et ajoute Coinbase Commerce comme méthode de paiement standard dans WooCommerce. L'intégration API directe nécessite du développement : vous créez les charges via des appels REST, écoutez les webhooks avec votre propre endpoint, et gérez les statuts de commande manuellement. L'API offre plus de contrôle (checkout custom, logique métier spécifique, intégration ERP) mais demande des compétences techniques solides et une maintenance continue.

Coinbase Commerce : Tuto Shopify & WooCommerce (2026)