Saldo & facturering

Gebruik de gebruikersfactureringsendpoints om het kredietsaldo van je team te lezen en opwaarderingen te kopen met een opgeslagen betaalmethode. Beide endpoints vereisen authenticatie met je API-sleutel. Ongeldige sleutels geven 402 terug.

Controleer kredietsaldo

GET /user/credits/info retourneert het kredietsaldo van het geauthenticeerde team, een uitsplitsing per lot, details van actieve abonnementen en of gebruik is toegestaan. Gebruik dit endpoint om factureringswidgets, gebruiksdashboards of pre-flight checks te ondersteunen voordat je grote taken uitvoert. Voor API-details zie Krijg kredietinformatie.

import requests

response = requests.get(
    "https://api.olostep.com/user/credits/info",
    headers={"Authorization": "Bearer <YOUR_API_KEY>"},
)
print(response.json())

const res = await fetch("https://api.olostep.com/user/credits/info", {
  headers: { Authorization: "Bearer <YOUR_API_KEY>" },
})
console.log(await res.json())

curl -s "https://api.olostep.com/user/credits/info" \
  -H "Authorization: Bearer <YOUR_API_KEY>"

Antwoord

{
  "credits": 12500,
  "breakdown": [
    {
      "purchase_kind": "Subscription",
      "allocated_units": 10000,
      "remaining_units": 8500,
      "expiry_date": 1735689600
    },
    {
      "purchase_kind": "Top-up",
      "allocated_units": 5000,
      "remaining_units": 4000,
      "expiry_date": 1743465600
    }
  ],
  "active_subscription": {
    "id": "SUB_PRO",
    "display_name": "Pro",
    "credits": 10000,
    "created_at": 1704067200
  },
  "allow_usage": true
}

Veld	Beschrijving
`credits`	Totaal resterende credits over alle niet-verlopen loten
`breakdown`	Detail per lot: type, toegewezen en resterende eenheden, vervaldatum
`active_subscription`	Huidig plan (valt terug op `SUB_BASE` als er geen actief is)
`allow_usage`	Of het team nog credits kan verbruiken

Elk lot in breakdown heeft een purchase_kind van Subscription, Top-up, Manual, Setup, of Pending.

Koop een opwaardering

POST /user/purchase-topup belast een opgeslagen kaart op Stripe en koopt credits in één stap. Er is geen Checkout-omleiding of ingebedde betalingsinterface. Geef het kredietbedrag door in de aanvraag:

{ "credits": 10000 }

Veld	Beschrijving
`credits`	Aantal te kopen credits

Ondersteunde waarden: 10,000, 20,000, 80,000, en 100,000. Voor API-details zie Koop opwaardering.

import requests

response = requests.post(
    "https://api.olostep.com/user/purchase-topup",
    headers={
        "Authorization": "Bearer <YOUR_API_KEY>",
        "Content-Type": "application/json",
    },
    json={"credits": 10000},
)
print(response.status_code)
print(response.json())

const res = await fetch("https://api.olostep.com/user/purchase-topup", {
  method: "POST",
  headers: {
    Authorization: "Bearer <YOUR_API_KEY>",
    "Content-Type": "application/json",
  },
  body: JSON.stringify({ credits: 10000 }),
})
console.log(res.status)
console.log(await res.json())

curl -s -X POST "https://api.olostep.com/user/purchase-topup" \
  -H "Authorization: Bearer <YOUR_API_KEY>" \
  -H "Content-Type: application/json" \
  -d '{"credits": 10000}'

Vereisten

Het team moet een Stripe-klant hebben met ten minste één opgeslagen kaart.
Er is slechts één aankooppoging toegestaan elke 60 seconden per team. Als je de cooldown raakt, is de respons 429 met een Retry-After header.

Antwoorden

200 — betaling geslaagd:

{
  "success": true,
  "payment_intent_id": "pi_xxx",
  "credits": 10000
}

202 — betaling is nog in verwerking. Credits worden toegevoegd zodra Stripe de betaling bevestigt:

{
  "success": true,
  "status": "processing",
  "payment_intent_id": "pi_xxx",
  "message": "Betaling wordt verwerkt. Credits worden toegevoegd zodra de betaling is bevestigd.",
  "credits": 10000
}

Credits worden uitgegeven door de Stripe-webhook na betalingsbevestiging, niet direct vanuit de HTTP-respons. Behandel 200 als betalingssucces; poll GET /user/credits/info als je het bijgewerkte saldo wilt bevestigen.

Veelvoorkomende fouten

Status	Fout	Wanneer
400	`missing_topup_selector`	`credits` was niet verzonden
400	`invalid_credits`	Kredietbedrag staat niet in de toegestane lijst
400	`no_stripe_customer`	Team heeft geen Stripe-klant
400	`no_payment_method`	Geen opgeslagen kaart in bestand
402	`payment_failed`	Geen opgeslagen kaart voltooide de betaling
429	`purchase_topup_cooldown`	Er werd binnen 60 seconden een andere aankoop geprobeerd
503	`payment_status_unknown`	Onduidelijke Stripe-fout; wacht voordat je opnieuw probeert

Automatische bijvullingen

Om te voorkomen dat je saldo opraakt, controleer je het volgens een schema en koop je een opwaardering wanneer het onder een drempel zakt. Dit gebruikt de twee bovenstaande endpoints en werkt overal waar je een script kunt uitvoeren: een cron-taak, een CI-stap, een serverloze functie of een AI-agent voor een grote taak.

Roep GET /user/credits/info aan en lees credits.
Als credits onder je drempel ligt, roep POST /user/purchase-topup aan met een van de ondersteunde bedragen.
Bij 200 of 202, stop. Credits komen binnen zodra Stripe de betaling bevestigt, dus koop niet opnieuw bij de volgende controle totdat het saldo is bijgewerkt.

import os
import requests

API = "https://api.olostep.com"
HEADERS = {"Authorization": f"Bearer {os.environ['OLOSTEP_API_KEY']}"}
THRESHOLD = 2000      # bijvullen wanneer saldo onder deze waarde zakt
TOPUP_CREDITS = 10000  # 10000, 20000, 80000, of 100000

credits = requests.get(f"{API}/user/credits/info", headers=HEADERS).json()["credits"]

if credits < THRESHOLD:
    res = requests.post(
        f"{API}/user/purchase-topup",
        headers=HEADERS,
        json={"credits": TOPUP_CREDITS},
    )
    print(res.status_code, res.json())
else:
    print(f"Saldo OK: {credits} credits")

const API = "https://api.olostep.com"
const headers = {
  Authorization: `Bearer ${process.env.OLOSTEP_API_KEY}`,
  "Content-Type": "application/json",
}
const THRESHOLD = 2000 // bijvullen wanneer saldo onder deze waarde zakt
const TOPUP_CREDITS = 10000 // 10000, 20000, 80000, of 100000

const { credits } = await (await fetch(`${API}/user/credits/info`, { headers })).json()

if (credits < THRESHOLD) {
  const res = await fetch(`${API}/user/purchase-topup`, {
    method: "POST",
    headers,
    body: JSON.stringify({ credits: TOPUP_CREDITS }),
  })
  console.log(res.status, await res.json())
} else {
  console.log(`Saldo OK: ${credits} credits`)
}

#!/usr/bin/env bash
# Vereist jq. Bijvullen wanneer saldo onder THRESHOLD zakt.
THRESHOLD=2000
TOPUP_CREDITS=10000

credits=$(curl -s "https://api.olostep.com/user/credits/info" \
  -H "Authorization: Bearer $OLOSTEP_API_KEY" | jq '.credits')

if [ "$credits" -lt "$THRESHOLD" ]; then
  curl -s -X POST "https://api.olostep.com/user/purchase-topup" \
    -H "Authorization: Bearer $OLOSTEP_API_KEY" \
    -H "Content-Type: application/json" \
    -d "{\"credits\": $TOPUP_CREDITS}"
else
  echo "Saldo OK: $credits credits"
fi

Om de controle elk uur met cron uit te voeren:

0 * * * * OLOSTEP_API_KEY=your_key /usr/bin/python3 /path/to/refill.py

Kies een drempel die je gebruik tussen controles dekt. Als je de controle elk uur uitvoert en ongeveer 1.000 credits per uur gebruikt, laat een drempel van 2.000 een buffer terwijl een opwaardering wordt verwerkt.

Elke uitvoering kan je opgeslagen kaart belasten. Voer slechts één bijvulopdracht per team uit en behandel 429 (purchase_topup_cooldown) en 503 (payment_status_unknown) door te wachten op de volgende geplande controle in plaats van direct opnieuw te proberen. Een 402 (payment_failed) betekent dat je kaart werd geweigerd; werk deze bij in het dashboard voor de volgende uitvoering.

Get Started

Features

Balance & Billing

Controleer kredietsaldo

Antwoord

Koop een opwaardering

Vereisten

Antwoorden

Veelvoorkomende fouten

Automatische bijvullingen

​Controleer kredietsaldo

​Antwoord

​Koop een opwaardering

​Vereisten

​Antwoorden

​Veelvoorkomende fouten

​Automatische bijvullingen

Controleer kredietsaldo

Antwoord

Koop een opwaardering

Vereisten

Antwoorden

Veelvoorkomende fouten

Automatische bijvullingen