Skip to main content

PlayerWalletTransaction

One player-wallet ledger entry: top-ups, usage debits, auto-recharges, refunds, purchases, payouts and adjustments. A usage debit carries the app and charges what one dimension's running total for its period now costs beyond what was already charged, the app's markup included, so a period can bring several debits as its usage arrives; its description names the dimension and the period.

type PlayerWalletTransaction {
  transactionId: BigInt!
  walletId: BigInt!
  userId: BigInt!
  amountMicrousd: BigInt!
  balanceAfterMicrousd: BigInt!
  amountCents: BigInt! @deprecated
  balanceAfter: BigInt! @deprecated
  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.amountMicrousd ● BigInt! non-null scalar​

Signed amount in micro-USD (debits negative). Exact.

PlayerWalletTransaction.balanceAfterMicrousd ● BigInt! non-null scalar​

Balance in micro-USD after this entry.

PlayerWalletTransaction.amountCents ● BigInt! deprecated non-null scalar​

DEPRECATED

Derived from amountMicrousd (truncated toward zero). Read amountMicrousd.

DEPRECATED. amountMicrousd / 10,000 truncated toward zero.

PlayerWalletTransaction.balanceAfter ● BigInt! deprecated non-null scalar​

DEPRECATED

Derived from balanceAfterMicrousd. Read balanceAfterMicrousd.

DEPRECATED. balanceAfterMicrousd / 10,000 truncated toward zero.

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" (metered player usage in one app: the increase in what one dimension's period total costs since the last debit for it, markup included, negative), "purchase" (marketplace purchase, negative), "adjustment" (operator or dispute-clawback correction, signed).

PlayerWalletTransaction.description ● String scalar​

Human description.

PlayerWalletTransaction.referenceId ● String scalar​

External reference: the checkout or PaymentIntent id of a top-up, or for a usage debit the ledger charge it settles ("charge:<chargeId>:<n>", the n-th debit of that charge).

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