---
title: Documentation
description: Documentation développeur Coinetic : démarrage rapide, signature des requêtes API, factures, page de paiement crypto, webhooks, remboursements, sandbox.
url: https://coinetic.money/fr/docs/
lang: fr
---

# 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émarrage rapide](https://coinetic.money/fr/docs/quickstart/) — Un premier paiement test en 15 minutes : facture, redirection, webhook.
- [Clients et exemples](https://coinetic.money/fr/docs/sdks/) — Node.js, PHP, Python, Go : un seul fichier, sans dépendances.
- [Webhooks](https://coinetic.money/fr/docs/webhooks/) — Événements, signature, nouvelles tentatives et ordre de livraison.
- [Checklist de mise en production](https://coinetic.money/fr/docs/go-live/) — Ce qu’il faut vérifier avant d’encaisser de vrais paiements.

## Déroulement d’un paiement

`flux de 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

| Environnement | API | Tableau de bord |
| --- | --- | --- |
| Production | `https://pay.coinetic.money` | [https://dash.coinetic.money/merchant](https://dash.coinetic.money/merchant) |
| Sandbox | `https://sandbox.coinetic.money` | [https://sandbox.coinetic.money/merchant](https://sandbox.coinetic.money/merchant) |

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

| Méthode | Chemin | Rôle |
| --- | --- | --- |
| POST | `/v1/invoices` | [Créer une facture](https://coinetic.money/fr/docs/invoices/) |
| GET | `/v1/invoices/{id}` | Facture, paiements, confirmations |
| GET | `/v1/invoices` | Liste des factures avec filtres et curseur |
| GET | `/v1/assets` | Actifs disponibles et montants minimaux |
| GET | `/v1/rates` | Taux de référence (consensus des plateformes d’échange) |
| POST | `/v1/refunds` | [Demande de remboursement](https://coinetic.money/fr/docs/refunds/) |