AccountTransaction

amountAmountrequired

balanceBalancerequired

category objectrequired

anyOf

• BalanceCategory
• string

Balance transaction categories mirrored from billing-service.

Must stay a superset of TransactionCategory in billing-service src/balance/api/v1/schemas.py — a category that billing can emit but this enum lacks used to fail response serialization with an unhandled ValidationError (HTTP 500, see INCIDENT_2026_05_20 follow-up: transactions re-categorized to manual-adjustment broke GET /accounts/transactions for the affected users). AccountTransaction.category additionally falls back to a plain string for unknown values so a future billing-side category never 500s this endpoint again.

BalanceCategory

Balance transaction categories mirrored from billing-service.

Must stay a superset of TransactionCategory in billing-service src/balance/api/v1/schemas.py — a category that billing can emit but this enum lacks used to fail response serialization with an unhandled ValidationError (HTTP 500, see INCIDENT_2026_05_20 follow-up: transactions re-categorized to manual-adjustment broke GET /accounts/transactions for the affected users). AccountTransaction.category additionally falls back to a plain string for unknown values so a future billing-side category never 500s this endpoint again.

Possible values: [funding, refund, withdraw, shop, direct-top-up, steam-gifts, manual-adjustment]

createdAtstring<date-time>required

currencyCurrencyrequired

description object

anyOf

• string
• null

string

idIdrequired

orderIdOrderidrequired

orderIdRaw object

anyOf

• string
• null

string

transactionIdTransactionidrequired

AccountTransaction

{
  "amount": 0,
  "balance": 0,
  "category": "funding",
  "createdAt": "2024-07-29T15:51:28.071Z",
  "currency": "string",
  "description": "string",
  "id": "string",
  "orderId": "string",
  "orderIdRaw": "string",
  "transactionId": "string"
}