Obtener estado de facturación
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
}Facturación
Obtener estado de facturación
Devuelve el estado de facturación actual, el modo de características y el período de gracia para el inquilino autenticado.
GET
/
v1
/
billing
/
status
Obtener estado de facturación
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 es NORMAL y grace_until es null. Si un pago falla, la cuenta entra en un flujo de trabajo de acceso gradual —Degradado, Restringido y luego Suspendido— con un período de gracia en cada etapa.
Respuesta
El nivel actual de capacidad de características:
NORMAL— todas las funciones disponiblesDEGRADED— el pago falló; todas las funciones siguen funcionando durante el período de graciaRESTRICTED— el período de gracia está a punto de expirar; las operaciones de escritura (acuñación, creación de claves) están deshabilitadasSUSPENDED— el período de gracia ha expirado; todo el acceso a la API está deshabilitado hasta que se resuelva el pago
Marca de tiempo ISO 8601 de cuándo finaliza el período de gracia actual, o
null si la cuenta está al día.Un mensaje legible que describe la acción requerida, o
null cuando no se necesita ninguna acción.Cuándo usar este endpoint
UseGET /v1/billing/status para:
- Mostrar avisos de pago — verifique
feature_modeal iniciar la aplicación o iniciar sesión y muestre un banner cuando el valor sea diferente deNORMAL. - Proteger operaciones de escritura — antes de acuñar o crear claves, verifique que
feature_modeno seaRESTRICTEDoSUSPENDED. - Seguimiento de plazos de gracia — lea
grace_untilpara mostrar a sus usuarios exactamente cuánto tiempo tienen para resolver un problema de pago.
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);
}
Plazo de gracia
Las ventanas de gracia predeterminadas para el modo de contrato Estándar son:| Transición | Ventana de gracia | Notificaciones |
|---|---|---|
| NORMAL → DEGRADADO | 7 días | Recordatorios a T+24h, T+48h, T+72h |
| DEGRADADO → RESTRINGIDO | 14 días | Recordatorios en T+24h, T+48h, T+72h |
| RESTRINGIDO → SUSPENDIDO | Inmediato | Aviso final de suspensión |
Consulte fallos de pago y períodos de gracia para un desglose completo del flujo de trabajo de acceso gradual.

