Zahlungsstatus abrufen

Liest den lokal gespeicherten Checkout der Organisation. Webhook und begrenzter Hintergrundabgleich aktualisieren den Status.

GET https://tokenlane.de/api/credits/topups/{id}

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' \
  --header 'Authorization: Bearer YOUR_API_KEY'

node

const response = await fetch("https://tokenlane.de/api/credits/topups/top_01k7tm3w8vfz6b2r4m9q5xyz7c", {
  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",
    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", {
  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",
  "amount": "YOUR_AMOUNT",
  "fee": "YOUR_FEE",
  "total": "YOUR_TOTAL",
  "currency": "EUR",
  "testMode": true,
  "status": "creating",
  "paymentMethod": "YOUR_PAYMENTMETHOD",
  "scaStatus": "unknown",
  "availableAt": "YOUR_AVAILABLEAT",
  "heldAmount": "YOUR_HELDAMOUNT",
  "checkoutUrl": "YOUR_CHECKOUTURL",
  "createdAt": "YOUR_CREATEDAT"
}

s22: object

{}

  • id (Pflichtfeld): s35

s35: string

{}

  • amount (Pflichtfeld): s35
  • fee (Pflichtfeld): s35
  • total (Pflichtfeld): s35
  • currency (Pflichtfeld): s81

s81: string

"EUR"

{}

  • testMode (Pflichtfeld): s83

s83: boolean

true

{}

  • status (Pflichtfeld): s23

s23: string

"creating", "open", "pending", "authorized", "paid", "canceled", "expired", "failed"

{}

  • paymentMethod (Pflichtfeld): s84

s84: string | null

{"maxLength":"64"}

  • scaStatus (Pflichtfeld): s85

s85: string

"unknown", "normal", "3dsecure", "wallet", "mandate", "legacy"

{}

  • availableAt (Pflichtfeld): s86

s86: string | null

date-time

{}

  • heldAmount (Pflichtfeld): s35
  • checkoutUrl (Pflichtfeld): s87

s87: string | null

{}

  • 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

Berechtigungsumfang reicht nicht aus: authentifiziert, aber nicht berechtigt.

{
  "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

Aktuell veröffentlichte Bedingungen vor Fortsetzen dieser Sitzung lesen und akzeptieren

{
  "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"
}