Coinetic-Dokumentation

Alles, um Krypto-Zahlungen auf Website, in App oder Bot zu akzeptieren. Die Integration besteht aus zwei API-Aufrufen und einem Webhook-Handler.

So läuft eine Zahlung ab

 Ihr Server                      Coinetic                           Kunde
 ──────────                      ────────                           ─────
 1. POST /v1/invoices  ────────▶ erstellt Rechnung, liefert checkout_url
 2. Redirect auf checkout_url ────────────────────────────────────▶ Bezahlseite
                                 3. Kunde wählt Währung ◀────────── (USDT, USDC, BTC…)
                                    und zahlt an die angezeigte Adresse
                                 4. Netzwerk bestätigt Zahlung
 5. Webhook invoice.paid ◀────── POST an Ihre URL (HMAC-Signatur)
 6. GET /v1/invoices/{id} ─────▶ Status gegenprüfen
 7. Bestellung ausliefern
                                 8. „Zurück zum Shop“ ────────────▶ Ihre return_url

Vier Regeln

• Das Secret des API-Schlüssels bleibt auf Ihrem Server. Nicht im Browser, nicht in der mobilen App, nicht in Git.
• Den Zahlungsstatus liefert nur Coinetic. Vertrauen Sie weder Parametern in der return_url noch blind dem Webhook: Prüfen Sie die Signatur und dann den Status über GET /v1/invoices/{id}.
• Geld ist ein String. Beträge kommen als Dezimal-Strings ("49.99") oder als Strings in kleinsten Einheiten ("49990000"). Wandeln Sie sie nie in Float um.
• Jede ändernde Anfrage mit Idempotency-Key. Eine Wiederholung nach einem Timeout liefert dieselbe Rechnung, statt eine zweite anzulegen.

Basis-URLs

Alle Antworten sind JSON in UTF-8, Zeitangaben RFC 3339 in UTC. Den vollständigen formalen Vertrag als OpenAPI 3 (openapi.yaml) erhalten Sie beim Support oder im Dashboard.

Alle Händler-Endpunkte