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

One of 'topup', 'usage_debit', 'auto_recharge', 'refund', 'adjustment'.

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