De l’inscription au premier paiement
en sept étapes
L’assistant de configuration du tableau de bord fait l’essentiel. Côté développeur : une cinquantaine de lignes de code sur le serveur.
-
2 minutes
Inscrivez-vous
Dans le tableau de bord, cliquez sur « Inscription » : nom de l’entreprise, e-mail, mot de passe. Confirmez votre e-mail via le lien reçu.
-
1 minute
Activez la double authentification
Obligatoire pour tous : une application d’authentification (TOTP). L’assistant de configuration démarre ensuite. Vous pourrez ajouter des clés d’accès (passkeys) plus tard.
-
10 minutes
Indiquez vos portefeuilles de réception
C’est là qu’arrivent les paiements. Seules des données publiques sont nécessaires : ne saisissez jamais votre phrase de récupération (seed) ni vos clés privées, ni chez nous, ni ailleurs.
- Bitcoin, Litecoin, TRON : le xpub/zpub du compte depuis Ledger Live, Sparrow, Trust Wallet, etc. ; nous affichons les premières adresses, vérifiez qu’elles correspondent à votre portefeuille.
- Ethereum, BSC, Polygon, Base, Arbitrum : un portefeuille de collecte (de préférence un multisig Safe).
- Solana : l’adresse du destinataire.
-
1 minute
Choisissez les actifs
Quelles cryptos et quels réseaux proposer à vos clients. Le plus simple est de commencer par les stablecoins USDT et USDC : parité 1:1 avec le dollar, sans risque de change.
-
2 minutes
Créez une clé API et un webhook
« Clés et webhooks » : le secret de la clé et celui du webhook ne s’affichent qu’une seule fois. Placez-les aussitôt dans un gestionnaire de secrets ou dans les variables d’environnement du serveur.
-
1 soirée
Intégrez et testez dans la sandbox
Création de facture, redirection, gestionnaire de webhook. La sandbox dispose de son propre tableau de bord et de ses propres clés, avec des paiements sans argent réel. Déroulez les scénarios : paiement exact, sous-paiement puis complément, surpaiement, facture expirée, webhook renvoyé.
- Démarrage rapide : code pour Node.js, PHP, Python et Go
- Sandbox : paiements de test en un clic
-
après vérification
Soumettez votre compte et lancez-vous
L’assistant envoie votre demande pour vérification. Une fois approuvée, générez une clé de production distincte et suivez la checklist de mise en production.
Ce dont vous aurez besoin
- Des portefeuilles que vous contrôlezUn portefeuille matériel ou un multisig : plus sûr qu’un portefeuille mobile pour une entreprise.
- Un serveur en HTTPSLes webhooks ne sont acceptés qu’en
https://sur le port 443 (en sandbox,localhostaussi). - Une horloge synchroniséeLa signature d’une requête est valable ±5 minutes : activez NTP.
- Un endroit pour les secretsGestionnaire de secrets ou variables d’environnement. Ni git, ni navigateur, ni application mobile.
Tout le code en un seul schéma
# 1. Le client a cliqué sur « Payer »
invoice = client.createInvoice({order_id, price_amount: "49.99", price_currency: "USD",
return_url}, idempotencyKey = "order-" + order_id)
redirect(invoice.checkout_url)
# 2. Coinetic a envoyé un webhook (corps brut !)
event = verifyWebhook(WEBHOOK_SECRET, headers, rawBody) # sinon 400/401
if seen(event.id): return 200 # livraison répétée
inv = client.getInvoice(event.data.invoice_id) # statut : uniquement via l’API
if inv.status in ["paid", "overpaid"]: grantOnce(inv.order_id)
return 200
Prêt à commencer ?
L’inscription est gratuite, la sandbox aussi.