Sviluppatori · API v1

API per ricariche Steam per negozi e bot

Ricarica i portafogli Steam tramite login direttamente dal tuo negozio, bot Telegram o CRM. Una richiesta POST effettua l'ordine dal tuo credito in USD; la risposta contiene il codice dell'ordine e il prezzo, e lo stato segue con GET. I prezzi sono gli stessi del sito, $0.8843 per dollaro del portafoglio.

Leggi la guida rapida Ottieni una chiave API

Richiesta

POST /api/v1/orders
Authorization: Bearer stk_live_...

{
  "login": "gamer_alex2009",
  "amount": "20.00"
}

201 Created

{
  "ok": true,
  "order": {
    "id": "SO-7KQ2M9XH4C",
    "login": "gamer_alex2009",
    "amount": "20.00",
    "price": "17.69",
    "status": "processing"
  }
}

Una POST effettua l'ordine

Chiave Bearer dal tuo account

Endpoint prezzo gratuito, nessuna chiave

Stato per codice ordine

Guida rapida

curl -X POST https://steamtopup.io/api/v1/orders \
  -H "Authorization: Bearer stk_live_..." \
  -H "Content-Type: application/json" \
  -d '{"login":"gamer_alex2009","amount":"20.00"}'

Un nuovo ordine risponde con stato in elaborazione. Leggi GET /api/v1/orders/{id} fino a quando non dice completato, o rimborsato se non è stato possibile consegnarlo (il prezzo viene quindi riaccreditato). GET /api/v1/price restituisce il prezzo esatto prima di qualsiasi addebito. Limiti: 300 richieste al minuto per chiave; importi da $0.65 a $850 per ordine.

Endpoint

Metodo	Percorso	Autenticazione	Cosa fa
GET	/api/v1/price?amount=20	Nessuna chiave	Prezzo e stime KZT/UAH per un importo
GET	/api/v1/regions	Nessuna chiave	Paesi supportati e valute del portafoglio
GET	/api/v1/balance	Chiave	Saldo credito in USD
POST	/api/v1/orders	Chiave	Effettua una ricarica: login e importo
GET	/api/v1/orders/{id}	Chiave	Stato di un ordine
GET	/api/v1/orders	Chiave	I tuoi ultimi 100 ordini

Errori

HTTP	error	Significato	Credito addebitato
400	bad_login	Il formato del login non è un nome di login Steam	No
400	bad_amount	Importo fuori dal range $0.65 a $850	No
401	unauthorized	Chiave API mancante o errata	No
402	funds	Credito inferiore al prezzo (necessario = USD mancanti)	No
429	rate_limited	Più di 300 richieste al minuto	No
503	network	Il ricarica non può essere inviata al momento; riprova più tardi	No

A chi è rivolto

Negozi di giochi e bot Telegram

Vendi ricariche Steam nel tuo negozio o bot, accetta pagamenti come preferisci e lascia che l'API consegni al login Steam del cliente.

Rivenditori

Acquista da un saldo in crediti USD e rivendi con il tuo margine. L'endpoint del prezzo ti mostra il costo di qualsiasi importo prima dell'ordine.

CRM e automazione

Aggiungi ricariche Steam ai programmi fedeltà, tornei e giveaway: una chiamata HTTP per ogni vincitore.

Club e comunità di gioco

Finanzia gli account dei membri da un unico saldo con una cronologia ordini chiara per ogni login.