---
title: Dokumentation
description: Coinetic-Dokumentation für Entwickler: Schnellstart, API-Signatur, Rechnungen, Bezahlseite, Webhooks, Erstattungen und Sandbox für Krypto-Zahlungen.
url: https://coinetic.money/de/docs/
lang: de
---

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

- [Schnellstart](https://coinetic.money/de/docs/quickstart/) — Die erste Testzahlung in 15 Minuten: Rechnung, Redirect, Webhook.
- [Clients und Beispiele](https://coinetic.money/de/docs/sdks/) — Node.js, PHP, Python, Go – je eine Datei ohne Abhängigkeiten.
- [Webhooks](https://coinetic.money/de/docs/webhooks/) — Ereignisse, Signatur, Wiederholungen und Zustellreihenfolge.
- [Go-live-Checkliste](https://coinetic.money/de/docs/go-live/) — Was Sie prüfen sollten, bevor echtes Geld fließt.

## So läuft eine Zahlung ab

`Zahlungsablauf`

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

| Umgebung | API | Dashboard |
| --- | --- | --- |
| Produktion | `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) |

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

| Methode | Pfad | Funktion |
| --- | --- | --- |
| POST | `/v1/invoices` | [Rechnung erstellen](https://coinetic.money/de/docs/invoices/) |
| GET | `/v1/invoices/{id}` | Rechnung, Zahlungen, Bestätigungen |
| GET | `/v1/invoices` | Rechnungsliste mit Filtern und Cursor |
| GET | `/v1/assets` | Verfügbare Assets und Mindestbeträge |
| GET | `/v1/rates` | Referenzkurs (Börsenkonsens) |
| POST | `/v1/refunds` | [Erstattung beantragen](https://coinetic.money/de/docs/refunds/) |