Documentation Coinetic

Tout ce qu’il faut pour accepter les cryptomonnaies sur votre site, dans votre application ou votre bot. L’intégration tient en deux requêtes API et un gestionnaire de webhook.

Déroulement d’un paiement

 Votre serveur                   Coinetic                           Client
 ─────────────                   ────────                           ──────
 1. POST /v1/invoices  ────────▶ crée la facture, renvoie checkout_url
 2. redirection vers checkout_url ────────────────────────────────▶ page de paiement
                                 3. le client choisit la devise ◀─── (USDT, USDC, BTC…)
                                    et paie à l’adresse indiquée
                                 4. le réseau confirme le paiement
 5. webhook invoice.paid ◀────── POST sur votre URL (signature HMAC)
 6. GET /v1/invoices/{id} ─────▶ revérification du statut
 7. livraison de la commande
                                 8. « Retour à la boutique » ───────▶ votre return_url

Quatre règles

• Le secret de la clé API reste sur votre serveur. Jamais dans le navigateur, ni dans une application mobile, ni dans git.
• Seul Coinetic fait foi pour le statut de paiement. Ne vous fiez pas aux paramètres de return_url et ne croyez pas un webhook sur parole : vérifiez la signature, puis revérifiez le statut via GET /v1/invoices/{id}.
• Les montants sont des chaînes. Ils arrivent sous forme de chaînes décimales ("49.99") ou de chaînes en unités minimales ("49990000"). Ne les convertissez jamais en float.
• Chaque requête de modification porte un Idempotency-Key. Une nouvelle tentative après un timeout renvoie la même facture au lieu d’en créer une deuxième.

URL de base

Toutes les réponses sont en JSON UTF-8, les dates au format RFC 3339 en UTC. Le contrat formel complet est au format OpenAPI 3 (openapi.yaml) : demandez-le au support ou récupérez-le dans le tableau de bord.

Tous les endpoints marchand