SIH Docs

Public API: Steam Refill From SIH Balance ​

This API lets an SIH user with an enabled public API key refill a Steam account by charging their SIH balance.

The flow is two-step:

  1. POST /p/api/v1.0/steam/check validates the Steam account and returns a transactionId.
  2. POST /p/api/v1.0/steam/pay uses that transactionId to charge SIH balance and complete the refill.

The transactionId is bound to the API key owner and expires after 1 hour.

Base URL ​

text
https://core.steaminventoryhelper.com

Authentication ​

Send the user's public API key in the api-key header:

http
api-key: <USER_API_KEY>
content-type: application/json

The API key must be:

  • generated by the user;
  • enabled by the user;
  • not disallowed by an administrator;
  • owned by a user account that is not locked.

Authentication failures return JSON errors, for example:

json
{
  "success": false,
  "error": "No API key provided"
}

Other possible authentication errors include:

  • Unauthorized: invalid API key.
  • Unauthorized: user is locked by administrator.
  • Access denied: the API key is disabled, enable it in your account settings.
  • Access denied: API key disabled by the administrator.
  • Access denied: API key disabled by the administrator. Comment: <admin comment>

Rate Limit ​

Each endpoint is limited independently to 1 request per 10 seconds per authenticated user. For example, check and pay have separate limits for the same user.

Rate limit response:

json
{
  "success": false,
  "error": "Rate limit exceeded",
  "retryAfter": 10
}

Status Codes ​

  • 200: Request processed. Some provider validation failures may still return success: false.
  • 400: Invalid input, invalid transaction, not enough balance, or payment provider failure.
  • 401: Missing or invalid API key.
  • 403: API key/user is not allowed, account is locked, or transaction belongs to another user.
  • 429: Rate limit exceeded.
  • 500: Internal service error or currency rate error.
  • 503: Temporary cache/transaction validation failure.

Integration Notes ​

  • Always call check immediately before pay.
  • Do not reuse a transactionId for a different Steam account, amount, user, or API key.
  • Retry pay with the same transactionId only when the previous request timed out or the client did not receive a response.
  • The SIH balance is charged only after the transaction ownership, rates, amount, and balance checks pass.