Rechnungsstatus abrufen
Rechnungsstatus einer eigenen Aufladung und lokalen Archivdownload abrufen
GET https://tokenlane.de/api/credits/topups/{id}/invoice
Authentifizierung
[ [ { "name": "Authorization", "description": "Management-Key der Organisation: Authorization: Bearer sk-tl-v1-…. Bestehende sk-eu--Keys bleiben gültig. Erforderliche Scopes stehen in x-scopes; Inferenz-Keys berechtigen nicht zu Verwaltungsoperationen.", "type": "http bearer", "location": "", "scopes": [] } ] ]
curl
curl --request GET \
--url 'https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/invoice' \
--header 'Authorization: Bearer YOUR_API_KEY'
node
const response = await fetch("https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/invoice", {
method: "GET",
headers: {
"Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
},
});
console.log(await response.text());
python
import os
import urllib.request
request = urllib.request.Request(
"https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/invoice",
method="GET",
headers={
"Authorization": "Bearer " + os.environ["TOKENLANE_API_KEY"],
},
)
with urllib.request.urlopen(request) as response:
print(response.read().decode("utf-8"))
vercel
// This operation uses HTTP directly.
const response = await fetch("https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c/invoice", {
method: "GET",
headers: {
"Authorization": "Bearer " + process.env.TOKENLANE_API_KEY,
},
});
console.log(await response.text());
Pfadparameter: id (Pflichtfeld)
Aufladungs-ID
s21: string
Aufladungs-ID
{}
"top_01k7tm3w8vfz6b2r4m9q5xyz7c"
Antwort 200: application/json
Anfrage erfolgreich
{
"id": "YOUR_ID",
"topupId": "YOUR_TOPUPID",
"status": "not_requested",
"invoiceNumber": "YOUR_INVOICENUMBER",
"downloadUrl": "YOUR_DOWNLOADURL",
"archivedAt": "YOUR_ARCHIVEDAT",
"creditNotes": [
{
"amount": "5.00",
"currency": "EUR",
"reason": "refund",
"status": "pending",
"createdAt": "YOUR_CREATEDAT"
}
]
}
s30: object
{}
- id (Pflichtfeld): s93
s93: string | null
Unveränderliche lokale Rechnungskennung als cin_-TypeID
{}
- topupId (Pflichtfeld): s35
s35: string
{}
- status (Pflichtfeld): s94
s94: string
"not_requested", "pending", "waiting_profile", "creating", "needs_review", "archiving", "ready", "legacy"
{}
- invoiceNumber (Pflichtfeld): s87
s87: string | null
{}
- downloadUrl (Pflichtfeld): s87
- archivedAt (Pflichtfeld): s87
- creditNotes (Pflichtfeld): s95
s95: array
Ausstehende Gutschriften für Rückzahlungen zu dieser Zahlung, älteste zuerst
{}
s161: object
{}
- amount (Pflichtfeld): s181
s181: string
{}
"5.00"
- currency (Pflichtfeld): s81
s81: string
"EUR"
{}
- reason (Pflichtfeld): s182
s182: string
Erstattung über Tokenlane, Erstattung im Mollie-Dashboard oder Rückbuchung
"refund", "external_refund", "chargeback"
{}
- status (Pflichtfeld): s183
s183: string
pending: Tokenlane erstellt die Gutschrift zu dieser Rechnung; void: Die Rückzahlung wurde rückgängig gemacht, es wird keine Gutschrift benötigt
"pending", "void"
{}
- createdAt (Pflichtfeld): s35
Antwort 400: application/json
Ungültige Anfrage: Validierungsfehler oder ungültige Eingabe.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
s11: object
{}
- requestId (optional): s56
s56: string
Serverseitige Zuordnungs-ID für einen internen Fehler. Auch in X-Request-Id enthalten.
uuid
{}
- status (Pflichtfeld): s57
s57: number
HTTP-Statuscode
{}
400
- code (Pflichtfeld): s58
s58: string
Fehlercode
{}
"VALIDATION_ERROR"
- message (Pflichtfeld): s59
s59: string
Fehlermeldung
{}
"Request validation failed"
- remedy_hint (optional): s60
s60: string
Sichere, ausführbare Abhilfe aus dem Fehlerkatalog.
{}
- details (optional): s61
s61: array
Detaillierte Validierungsfehler
{}
s154: object
{}
- path (Pflichtfeld): s179
s179: string
Feldpfad
{}
"title"
- message (Pflichtfeld): s180
s180: string
Fehlermeldung zum Feld
{}
"Required"
Antwort 401: application/json
Authentifizierung erforderlich: Zugangsdaten fehlen oder sind ungültig.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 403: application/json
Unzureichender Scope (authentifiziert, aber nicht berechtigt) | Diese Sitzung darf nur die Sicherheitseinrichtung aufrufen, bis der erforderliche Faktor verifiziert ist
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 404: application/json
Ressource nicht gefunden
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 409: application/json
Konflikt mit dem aktuellen Zustand, beispielsweise ein bereits vorhandener Name.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 429: application/json
Nach der angegebenen Wartezeit erneut versuchen
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 500: application/json
Interner Serverfehler
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Antwort 503: application/json
Konfigurierter Upstream hat das Zeitlimit überschritten, ist fehlgeschlagen oder hat eine ungültige Antwort geliefert.
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}