Comment démarrer

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.

  1. 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.

  2. 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.

  3. 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.
  4. 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.

  5. 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.

  6. 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é.

  7. 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, localhost aussi).
  • 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.
Pas de développeur ?Envoyez-lui le lien vers le démarrage rapide : tout y est, avec du code prêt à l’emploi.
Intégration minimale

Tout le code en un seul schéma

pseudo-code
# 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.