Read checkout status
Read an organization’s locally stored checkout; webhook and bounded background reconciliation update it
GET https://tokenlane.de/api/credits/topups/{id}
Authorizations
[ [ { "name": "Authorization", "description": "Organization management key: Authorization: Bearer sk-tl-v1-…. Existing sk-eu- keys remain valid. Required scopes are listed in x-scopes; gateway inference keys cannot authorize management operations.", "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());
path: id (required)
Top-up ID
s21: string
Top-up ID
{}
"top_01k7tm3w8vfz6b2r4m9q5xyz7c"
Response 200: application/json
Request successful
{
"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 (required): s35
s35: string
{}
- amount (required): s35
- fee (required): s35
- total (required): s35
- currency (required): s81
s81: string
"EUR"
{}
- testMode (required): s83
s83: boolean
true
{}
- status (required): s23
s23: string
"creating", "open", "pending", "authorized", "paid", "canceled", "expired", "failed"
{}
- paymentMethod (required): s84
s84: string | null
{"maxLength":"64"}
- scaStatus (required): s85
s85: string
"unknown", "normal", "3dsecure", "wallet", "mandate", "legacy"
{}
- availableAt (required): s86
s86: string | null
date-time
{}
- heldAmount (required): s35
- checkoutUrl (required): s87
s87: string | null
{}
- createdAt (required): s35
Response 400: application/json
Bad request (validation error, invalid input)
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
s11: object
{}
- requestId (optional): s56
s56: string
Server correlation ID for an internal error. Also returned in X-Request-Id.
uuid
{}
- status (required): s57
s57: number
HTTP status code
{}
400
- code (required): s58
s58: string
Error code
{}
"VALIDATION_ERROR"
- message (required): s59
s59: string
Error message
{}
"Request validation failed"
- remedy_hint (optional): s60
s60: string
A safe, actionable remedy from the error catalog.
{}
- details (optional): s61
s61: array
Detailed validation errors
{}
s154: object
{}
- path (required): s179
s179: string
Field path
{}
"title"
- message (required): s180
s180: string
Field error message
{}
"Required"
Response 401: application/json
Authentication required (missing or invalid credentials)
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Response 403: application/json
Insufficient scope (authenticated but not authorized)
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Response 404: application/json
Resource not found
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Response 409: application/json
Read and accept the currently published terms before continuing with this session
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Response 500: application/json
Internal server error
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}
Response 503: application/json
Configured upstream timed out, failed or returned an invalid response
{
"status": 400,
"code": "VALIDATION_ERROR",
"message": "Request validation failed"
}