Skip to main content

WalletTransaction

No description

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

Fields

WalletTransaction.transactionId ● BigInt! non-null scalar

Unique transaction id (BigInt as a decimal string).

WalletTransaction.walletId ● BigInt! non-null scalar

Wallet this transaction belongs to (BigInt as a decimal string).

WalletTransaction.orgId ● BigInt! non-null scalar

Organization that owns the wallet (BigInt as a decimal string).

WalletTransaction.amountCents ● BigInt! non-null scalar

Signed change applied to the wallet in minor currency units (cents), as a BigInt decimal string: positive credits funds, negative debits funds.

WalletTransaction.balanceAfter ● BigInt! non-null scalar

Wallet balance in cents immediately after this transaction was applied, as a BigInt decimal string.

WalletTransaction.transactionType ● String! non-null scalar

What produced this transaction. The complete set of values this API writes: "topup" (wallet credit from a completed checkout, positive), "admin_credit" (operator credit applied without a payment provider, positive), "auto_recharge" (off-session automatic wallet recharge, positive), "shared_usage" (hourly shared-environment metered charge for one closed clock hour, negative), "agent_usage" (Crowdy Studio agent run charged at provider cost, negative), "reserved_throughput" (monthly or prorated reserved capacity -- realtime bytes/s or GraphQL operations/s -- charged in addition to metered usage rather than including any of it, negative), "markup_payout" (the app developer's markup on a player's compute bill, credited to the org in the same transaction as the player debit that produced it, positive), "refund" (a payment-provider refund of a top-up, the credited amount leaving the wallet again, negative), "chargeback" (a card dispute on an org top-up, clawed back from the org wallet, negative). No other value is written; earlier versions of this description also listed "usage" and "environment_usage", neither of which was ever produced.

WalletTransaction.description ● String scalar

Optional human-readable note describing the transaction; null when not set.

WalletTransaction.referenceId ● String scalar

Optional external reference (e.g. payment-provider charge id or checkout id) linking this transaction to its source; null when not set.

WalletTransaction.appId ● BigInt scalar

App that incurred the charge (BigInt as a decimal string), set on usage-type transactions; null for org-level credits such as top-ups.

WalletTransaction.createdAt ● DateTime! non-null scalar

When the transaction was recorded (ISO-8601 UTC timestamp).

Returned By

walletTransactions query

Member Of

WalletTransactionEdge object