Skip to main content

PlayerWalletTransaction

One player-wallet ledger entry: top-ups, hourly usage debits, auto-recharges, refunds, and adjustments. Usage debits carry the app and reference the hour's charge row, whose snapshot splits platform vs studio-markup components.

type PlayerWalletTransaction {
  transactionId: BigInt!
  walletId: BigInt!
  userId: BigInt!
  amountCents: BigInt!
  balanceAfter: BigInt!
  transactionType: String!
  description: String
  referenceId: String
  appId: BigInt
  createdAt: DateTime!
}

Fields​

PlayerWalletTransaction.transactionId ● BigInt! non-null scalar​

Transaction id.

PlayerWalletTransaction.walletId ● BigInt! non-null scalar​

The wallet.

PlayerWalletTransaction.userId ● BigInt! non-null scalar​

The owning player user id.

PlayerWalletTransaction.amountCents ● BigInt! non-null scalar​

Signed amount in cents (debits negative).

PlayerWalletTransaction.balanceAfter ● BigInt! non-null scalar​

Balance after this entry.

PlayerWalletTransaction.transactionType ● String! non-null scalar​

What produced this entry. The complete set of values this API writes: "topup" (credit from a completed checkout, positive), "auto_recharge" (off-session automatic recharge, positive), "payout_credit" (marketplace seller payout, positive), "refund" (marketplace refund returned to the buyer, positive), "usage_debit" (hourly player-compute metered charge for one closed clock hour, negative), "purchase" (marketplace purchase, negative), "adjustment" (operator or dispute-clawback correction, signed).

PlayerWalletTransaction.description ● String scalar​

Human description.

PlayerWalletTransaction.referenceId ● String scalar​

External reference (checkout/PaymentIntent id).

PlayerWalletTransaction.appId ● BigInt scalar​

The app a usage debit covers; null for wallet-level entries.

PlayerWalletTransaction.createdAt ● DateTime! non-null scalar​

Entry time.

Returned By​

playerWalletTransactions query