Abrechnungsstatus abrufen
curl --request GET \
--url https://api.truthlocks.com/v1/billing/status \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/billing/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"plan": "<string>",
"status": "<string>",
"trial_ends_at": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}Abrechnung
Abrechnungsstatus abrufen
Gibt den aktuellen Abrechnungsstatus, den Funktionsmodus und die Nachfrist für den authentifizierten Mandanten zurück.
GET
/
v1
/
billing
/
status
Abrechnungsstatus abrufen
curl --request GET \
--url https://api.truthlocks.com/v1/billing/status \
--header 'X-API-Key: <api-key>'const options = {method: 'GET', headers: {'X-API-Key': '<api-key>'}};
fetch('https://api.truthlocks.com/v1/billing/status', options)
.then(res => res.json())
.then(res => console.log(res))
.catch(err => console.error(err));import requests
url = "https://api.truthlocks.com/v1/billing/status"
headers = {"X-API-Key": "<api-key>"}
response = requests.get(url, headers=headers)
print(response.text)package main
import (
"fmt"
"net/http"
"io"
)
func main() {
url := "https://api.truthlocks.com/v1/billing/status"
req, _ := http.NewRequest("GET", url, nil)
req.Header.Add("X-API-Key", "<api-key>")
res, _ := http.DefaultClient.Do(req)
defer res.Body.Close()
body, _ := io.ReadAll(res.Body)
fmt.Println(string(body))
}{
"plan": "<string>",
"status": "<string>",
"trial_ends_at": "<string>"
}{
"code": "AUTH_REQUIRED",
"message": "Authentication required",
"http_status": 401
}GET /v1/billing/status
feature_mode NORMAL und grace_until ist null. Wenn eine Zahlung fehlschlägt, tritt das Konto in einen gestuften Zugriffs-Workflow ein – Herabgestuft, Eingeschränkt, dann Gesperrt – mit einer Schonfrist in jeder Phase.
Antwort
Die aktuelle Funktionsfähigkeit:
NORMAL– alle Funktionen verfügbarDEGRADED– Zahlung fehlgeschlagen; alle Funktionen funktionieren während der Schonfrist weiterhinRESTRICTED– Schonfrist läuft ab; Schreibvorgänge (Prägen, Schlüsselerstellung) sind deaktiviertSUSPENDED– Schonfrist abgelaufen; der gesamte API-Zugriff ist deaktiviert, bis die Zahlung erfolgt ist
ISO 8601 Zeitstempel, wann die aktuelle Nachfrist endet, oder
null, wenn das Konto in gutem Zustand ist.Eine menschenlesbare Nachricht, die die erforderliche Aktion beschreibt, oder
null, wenn keine Aktion erforderlich ist.Wann dieser Endpunkt verwendet werden sollte
Verwenden SieGET /v1/billing/status, um:
- Zahlungsaufforderungen anzeigen – überprüfen Sie
feature_modebeim Start der App oder beim Login und zeigen Sie ein Banner an, wenn der Wert nichtNORMAList. - Schreiboperationen schützen – vor dem Prägen oder Erstellen von Schlüsseln überprüfen, ob
feature_modenichtRESTRICTEDoderSUSPENDEDist. - Kulanzfristen verfolgen – lesen Sie
grace_until, um Ihren Benutzern genau zu zeigen, wie lange sie Zeit haben, ein Zahlungsproblem zu lösen.
const res = await fetch("https://api.truthlocks.com/v1/billing/status", {
headers: { "X-API-Key": "tl_live_..." },
});
const { feature_mode, grace_until } = await res.json();
if (feature_mode !== "NORMAL") {
showPaymentBanner(feature_mode, grace_until);
}
Kulanzzeitraum
Die Standard-Kulanzfristen für den Standard-Vertragsmodus sind:| Übergang | Kulanzfrist | Benachrichtigungen |
|---|---|---|
| NORMAL → DEGRADIERT | 7 Tage | Erinnerungen bei T+24h, T+48h, T+72h |
| DEGRADIERT → EINGESCHRÄNKT | 14 Tage | Erinnerungen bei T+24h, T+48h, T+72h |
| EINGESCHRÄNKT → GESPERRT | Sofort | Letzte Sperrbenachrichtigung |
Eine vollständige Aufschlüsselung des gestuften Zugriffs-Workflows finden Sie unter Zahlungsausfälle und Kulanzfristen.

