Overview

A user cash balance account is a spending account that allows users to manage and track their available funds within the Fluz platform. Each cash balance account is identified by a unique nickname and maintains separate balances for total, available, and lifetime deposits. Users can create multiple cash balance accounts (e.g., "Team Travel", "Operations Wallet", "Marketing Budget") to organize their spending across different purposes.

Cash balance accounts are required for making deposits, purchasing gift cards, and funding virtual card transactions on the Fluz platform.

Create User Cash Balance Account

Sample request

You can create a new user cash balance account with the createUserCashBalance mutation. This mutation allows you to set up a new spending account with a custom nickname to help organize your funds. The query takes a CreateUserCashBalanceInput input object.

{
  "query": "mutation createUserCashBalance($input: CreateUserCashBalanceInput!) { createUserCashBalance(input: $input) { userCashBalanceId totalCashBalance availableCashBalance lifetimeCashBalance nickname status createdAt }}",
  "variables": {
    "input": {
      "nickname": "Team Travel"
    }
  }
}

This mutation requires the CreateUserCashBalanceInput input type. Any field marked with an exclamation mark (!) in the schema is mandatory and must be included in the request.

CreateUserCashBalanceInput

{
  "nickname": "Team Travel"
}

Sample response

The response from the createUserCashBalance mutation will include the newly created cash balance account details, including its unique identifier and initial balance information.

{
  "data": {
    "createUserCashBalance": {
      "userCashBalanceId": "f8a3c9e1-7b2d-4f5e-9c8a-1d2e3f4g5h6i",
      "totalCashBalance": "0",
      "availableCashBalance": "0",
      "lifetimeCashBalance": "0",
      "nickname": "Team Travel",
      "status": "ACTIVE",
      "createdAt": "2025-01-15T10:30:00.000Z"
    }
  }
}

Response Fields

❗️

Authorization required

This mutation requires the MANAGE_PAYMENT scope. Ensure your access token has been granted this scope before attempting to create a cash balance account.