Coinetic-documentatie

Alles om crypto te accepteren op uw website, in uw app of in uw bot. De integratie bestaat uit twee API-requests en één webhook-handler.

Zo werkt een betaling

 Uw server                       Coinetic                           Klant
 ─────────                       ────────                           ─────
 1. POST /v1/invoices  ────────▶ maakt factuur aan, geeft checkout_url terug
 2. redirect naar checkout_url ───────────────────────────────────▶ betaalpagina
                                 3. klant kiest valuta ◀──────────── (USDT, USDC, BTC…)
                                    en betaalt naar het getoonde adres
                                 4. netwerk bevestigt de betaling
 5. webhook invoice.paid ◀────── POST naar uw URL (HMAC-handtekening)
 6. GET /v1/invoices/{id} ─────▶ status opnieuw controleren
 7. bestelling leveren
                                 8. ‘Terug naar de winkel’ ────────▶ uw return_url

Vier regels

• Het secret van de API-sleutel staat alleen op uw server. Niet in de browser, niet in een mobiele app en niet in git.
• De betaalstatus komt alleen van Coinetic. Vertrouw geen parameters in return_url en neem een webhook niet zomaar voor waar aan: controleer de handtekening en controleer daarna de status opnieuw via GET /v1/invoices/{id}.
• Geld is een string. Bedragen komen binnen als decimale strings ("49.99") of als strings in de kleinste eenheid ("49990000"). Zet ze nooit om naar float.
• Elk wijzigend request krijgt een Idempotency-Key. Een retry na een time-out geeft dezelfde factuur terug in plaats van een tweede aan te maken.

Basis-URL's

Alle responses zijn JSON in UTF-8, tijden in RFC 3339 en UTC. Het volledige formele contract is OpenAPI 3 (openapi.yaml); vraag het op bij support of in het dashboard.

Alle merchant-endpoints