Account Balances

Your Fluz account can have up to four different balances:

Rewards balance - A withdrawalable balance that contains your available cashback and bonus rewards.
Cash balance (Spend Account) - Withdrawable balances that you can use to fund your gift card and virtual card purchases, among other uses.
Fluz prepayment balance - A non-withdrawable balance you can use towards gift card and virtual card purchases.
Reserve balance - A balance held in Fluz to cover any transactions that fail to settle, ensuring your account remains in good standing.

In order to see your current balances you can use the getWallet query. This can help you determine how much you want to deposit or apply towards a gift card purchase. The sum of these balances makes up your 'available Fluz balance', which determines the total amount you can use towards funding a payment on Fluz.

User Cash Balance Accounts (Spend Accounts)

You can access detailed information about individual cash balance accounts through the userCashBalances field. Monitoring account status and creation dates

The userCashBalances field supports pagination and returns an array of cash balance accounts ordered by creation date (most recent first).

Sample Response:

{
  "data": {
    "getWallet": {
      "bankCards": [BankCard],
      "bankAccounts": [BankAccount],
      "paypalAccounts": [Paypal],
      "blockedPaymentTypes": ["BANK_CARD"],
      "balances": {
        "rewardsBalance": {
          "availableBalance": "50.00",
          "totalBalance": "50.00",
          "lifetimeBalance": "125.00"
        },
        "cashBalance": {
          "availableBalance": "100.00",
          "totalBalance": "100.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "500.00"
        },
        "giftCardCashBalance": {
          "availableBalance": "25.00",
          "totalBalance": "25.00",
          "pendingBalance": "0.00",
          "lifetimeBalance": "75.00"
        },
        "userCashBalances": [
          {
            "userCashBalanceId": "123e4567-e89b-12d3-a456-426614174000",
            "totalCashBalance": "100.00",
            "availableCashBalance": "100.00",
            "lifetimeCashBalance": "500.00",
            "nickname": "Primary Account",
            "status": "ACTIVE",
            "createdAt": "2024-01-15T10:30:00Z"
          },
          {
            "userCashBalanceId": "223e4567-e89b-12d3-a456-426614174001",
            "totalCashBalance": "25.00",
            "availableCashBalance": "25.00",
            "lifetimeCashBalance": "75.00",
            "nickname": "Savings",
            "status": "ACTIVE",
            "createdAt": "2024-02-20T14:15:00Z"
          }
        ]
      }
    }
  }
}

Query with Pagination:

You can paginate through cash balance accounts using the paginate parameter:

query {
  getWallet {
    balances {
      userCashBalances(paginate: { limit: 10, offset: 0 }) {
        userCashBalanceId
        totalCashBalance
        availableCashBalance
        lifetimeCashBalance
        nickname
        status
        createdAt
      }
    }
  }
}

UserCashBalance Fields:

Field	Type	Description
`userCashBalanceId`	UUID	Unique identifier for the user cash balance account
`totalCashBalance`	String	Total cash balance in the account
`availableCashBalance`	String	Available cash balance that can be used for transactions
`lifetimeCashBalance`	String	Cumulative total ever deposited into this account
`nickname`	String	Custom nickname for the balance account (optional)
`status`	UserCashBalanceStatus	Status of the cash balance account (e.g., ACTIVE, INACTIVE)
`createdAt`	DateTime	Date and time when the account was created

Want to learn more? Contact us at [email protected]

Speak with our experts for more info or to request a demo.