Nutzung und Abrechnung
Die Nutzung der Organisation und die einzeln gebuchten Läufe lassen sich per API lesen, etwa um sie in die eigene Rechnungsstellung zu übernehmen. Rechnungen und Abo bleiben der Web-App vorbehalten.
Abrechnungsmodell der Agentur
Im Plan Agentur wird jeder Lauf einzeln berechnet, je Paket. Ein automatischer Lauf besteht aus einem oder mehreren der ersten vier Pakete, ein KI-Scan immer nur aus dem fünften:
| Paket | details.packages | Wann es gebucht wird |
|---|---|---|
| Sicherheit passiv | passive | security: true, active: false |
| Sicherheit aktiv | active | security: true, active: true |
| Datenschutz | privacy | privacy: true |
| Barrierefreiheit | accessibility | accessibility: true |
| KI-Scan (Beta) | ki | eine Anfrage über POST /v1/scans/ki |
- Domains kosten nichts. Berechnet werden nur Läufe.
- Den Preis je Paket vereinbaren wir mit jeder Agentur einzeln. Auch
0ist ein gültiger Preis und heißt: bewusst kostenlos. - Gebucht wird, wenn ein Lauf mit
doneendet, beim KI-Scan also erst mit dem fertigen Bericht. Der Betrag ist der Preis, der in diesem Moment gilt. Eine spätere Preisänderung ändert gebuchte Läufe nicht. - Fehlgeschlagene und abgebrochene Läufe (
failed,canceled) kosten nichts. - Datenschutz und Barrierefreiheit prüfen immer alle Unterseiten. Für die
Sicherheit entscheidet
full_site.
Ein Lauf mit Sicherheit, Datenschutz und Barrierefreiheit ergibt drei
Buchungen unter derselben scan_id.
Datenschutz ist nicht vorbelegt
Fehlt privacy in POST /v1/scans oder in
einem Zeitplan, ist Datenschutz bei Abrechnung je
Lauf aus. Wer ihn prüfen lassen will, sendet privacy: true. Bei Abrechnung
nach Kontingent (Plan Pro) ist Datenschutz ohne Angabe an.
Fehlender Preis
Ist für ein Paket des Laufs noch kein Preis vereinbart, weist die API den
Lauf beim Einreihen mit 402 price_not_set ab. details.packages nennt die
betroffenen Pakete. Läufe, die nur Pakete mit Preis enthalten, laufen weiter.
{
"code": "price_not_set",
"message": "…",
"details": { "packages": ["privacy"] },
"request_id": "req_9b1e44af0c37d2e5"
}Den Preis tragen wir ein, sprechen Sie uns dafür an. Kostet ein
Paket mehr als 0 und ist keine Zahlungsart hinterlegt, antwortet die API mit
402 payment_method_required.
Monatsrechnung
Die Rechnung kommt nachträglich zum Monatsende. Sie trägt eine Position je Paket und Stückpreis, als Menge mal Stückpreis.
- Ändert sich ein Preis mitten im Monat, steht dasselbe Paket zweimal auf der Rechnung: eine Position zum alten und eine zum neuen Stückpreis.
- Ein Paket zu
0Cent steht ebenfalls als Position auf der Rechnung. - Läufe, deren Buchung wir storniert haben, tragen keine Position.
Nutzung
https://api.red-check.de/v1/billing/usage
Zähler der laufenden Periode und der Verlauf der letzten Monate.
Gebuchte Läufe
https://api.red-check.de/v1/billing/usage/scans
Die Summe der Periode, gruppiert nach Kunde. Befüllt ist sie nur bei
Abrechnung je Lauf, sonst steht billing_mode auf quota und die Listen
sind leer. Mit from und to wählen Sie einen freien Zeitraum statt einer
Abrechnungsperiode.
Einzelne Buchungen
https://api.red-check.de/v1/billing/usage/scans/entries
Eine Zeile je gebuchtem Paket, seitenweise wie unter
Konventionen. amount_cents ist der
Betrag, der beim Lauf galt. Er wird gelesen, nie nachgerechnet.
Als CSV
https://api.red-check.de/v1/billing/usage/scans.csv
Dieselben Zeilen als CSV, mit Semikolon als Trennzeichen und Komma in Beträgen, damit deutsche Tabellenprogramme die Spalten erkennen.
curl -sS -o laeufe.csv \
"https://api.red-check.de/v1/billing/usage/scans.csv?from=2026-09-01&to=2026-09-30" \
-H "Authorization: Bearer $KEY"Rechte
| Aufruf | read_only | start_scans | full |
|---|---|---|---|
| die vier Aufrufe dieser Seite, Schlüssel ohne Domain-Einschränkung | ja | nein | ja |
| die vier Aufrufe dieser Seite, Schlüssel mit Domain-Einschränkung | nein | nein | nein |
| Rechnungen, Abo, Checkout | nein | nein | nein |