Transfer Funds Internally

transferInternalBalance

When you want to move money between your Fluz spend accounts, you can transfer funds between the two balances.

Transfer funds

To transfer funds between your Fluz spend accounts, use the transferInternalBalance mutation. This mutation accepts an input object type of TransferInternalBalanceInput

TransferInternalBalanceInput

Field	Type	Required	Description
amount	Float!	Yes	The amount you wish to transfer.
idempotencyKey	String!	Yes	A unique client-generated string to ensure idempotent request processing. If the same key is submitted multiple times, only the first request will be processed.
sourceUserCashBalanceId	UUID!	Yes	The cash balance (spend account) to withdraw your funds from
destinationUserCashBalanceId	UUID!	Yes	The cash balance (spend account) to deposit your funds to

Sample Request

mutation transferInternalBalance($input: TransferInternalBalanceInput!) {
  transferInternalBalance(input: $input) {
    cashBalanceDeposit {
      cashBalanceDepositId
      depositDisplayId
      depositAmount
      depositFee
      bankAccountId
      transactionDate
      clearedDate
      status
      expectedClearedDate
      cashBalanceDepositType
      cashBalanceSettlements {
        cashBalanceSettlementId
        cashBalanceDepositId
        availabilityType
        status
      }
    }
    withdraw {
      withdrawId
      amount
      processingFee
      chargedFee
      status
      displayStatus
      withdrawSource
      submissionDate
      createdAt
      updatedAt
      transactionLogId
      externalTransactionId
      payoutId
      emailAddress
      bankAccountId
      userCashBalanceId
      seatId
    }
  }
}

TransferInternalBalanceInput

{
  "idempotencyKey": "1f1df3e7-5d43-4e3d-83de-31922d4aefb7",
  "amount": 6.00,
  "sourceUserCashBalanceId": "6d1b4b19-deef-42f5-80d7-ec34804ce090",
  "destinationUserCashBalanceId": "bb584e49-d030-4a6e-a5a9-1c34368cbaed"
}

Sample Response

{
  "data": {
    "transferInternalBalance": {
      "cashBalanceDeposit": {
        "cashBalanceDepositId": "9179dfd0-4e6a-4ffb-838f-9612d5419a95",
        "depositDisplayId": "115289",
        "depositAmount": "6.00000",
        "depositFee": "0.00000",
        "bankAccountId": null,
        "transactionDate": "2025-12-12T17:07:04.070Z",
        "clearedDate": null,
        "status": "AVAILABLE",
        "expectedClearedDate": "2025-12-12T17:07:04.070Z",
        "cashBalanceDepositType": "CASH_BALANCE",
        "cashBalanceSettlements": [
          {
            "cashBalanceSettlementId": "18598af8-14fb-448a-8f10-40f8aab67c78",
            "cashBalanceDepositId": "9179dfd0-4e6a-4ffb-838f-9612d5419a95",
            "availabilityType": "INSTANT",
            "status": "AVAILABLE"
          }
        ]
      },
      "withdraw": {
        "withdrawId": "a846e295-2f5b-4ad8-a9e9-252bbc314478",
        "amount": "6",
        "processingFee": "0",
        "chargedFee": "0.00000",
        "status": "SUCCESS",
        "displayStatus": "SUCCESS",
        "withdrawSource": "CASH_BALANCE",
        "submissionDate": "2025-12-12T17:07:03.735Z",
        "createdAt": "2025-12-12T17:07:02.212Z",
        "updatedAt": "2025-12-12T17:07:02.212Z",
        "transactionLogId": null,
        "externalTransactionId": null,
        "payoutId": null,
        "emailAddress": null,
        "bankAccountId": null,
        "userCashBalanceId": "6d1b4b19-deef-42f5-80d7-ec34804ce090",
        "seatId": "db11ec6c-c371-4184-ab6a-3dfb2c92c4d3"
      }
    }
  }
}

Deposit Response

Once you initiate a transfer with the transferInternalBalance mutation, you will get a response providing details about the related deposit and a withdraw.

Field Name	Type	Description
cashBalanceDeposit	CashBalanceDeposit	A cash balance deposit made as part of the mutation.
withdraw	Withdraw	A withdraw made as part of the mutation.

The CashBalanceDeposit object will contain important information about the deposit you initiated.

Field Name	Type	Description
cashBalanceDepositId	UUID!	Unique identifier for the cash balance deposit.
depositDisplayId	String!	Display identifier for the deposit, intended for user-facing purposes.
depositAmount	String!	The amount of the deposit.
depositFee	String	Fee associated with the deposit, if applicable.
bankCardId	UUID	Identifier of the bank card used for the deposit.
bankAccountId	UUID	Identifier of the bank account used for the deposit.
paypalVaultId	UUID	Identifier of the PayPal vault used for the deposit.
transactionDate	DateTime!	Date and time when the transaction was made.
clearedDate	DateTime	Date and time when the deposit cleared, if applicable.
status	CashBalanceDepositStatus!	Current status of the deposit.
expectedClearedDate	DateTime!	Expected date and time for the deposit to clear.
cashBalanceDepositType	CashBalanceDepositType!	Type of the cash balance deposit, including CASH_BALANCE,	GIFT_CARD_PREPAYMENT,RESERVE_BALANCE.
cashBalanceSettlements	[CashBalanceSettlement]	Settlement time details for the deposit, including status and type.

The Withdraw object will contain important information about the deposit you initiated.

Field Name	Type	Description
withdrawId	UUID!	Unique identifier for the withdrawal.
amount	String!	The amount withdrawn.
processingFee	String!	Fee charged for processing the withdrawal.
chargedFee	String!	Fee charged to the user for the withdrawal.
status	String!	Internal status of the withdrawal.
displayStatus	String!	User-friendly display status of the withdrawal.
withdrawSource	WithdrawSource!	The source balance from which funds were withdrawn.
submissionDate	DateTime!	Date and time when the withdrawal was submitted.
createdAt	DateTime!	Date and time when the withdrawal was created.
updatedAt	DateTime!	Date and time when the withdrawal was last updated.
transactionLogId	UUID	Identifier of the associated transaction log.
externalTransactionId	String	External transaction identifier from payment gateway (for ACH).
payoutId	String	Payout identifier from payment gateway (for PayPal/Venmo).
emailAddress	String	Email address associated with the withdrawal.
bankAccountId	UUID	Identifier of the bank account used (if applicable).
userCashBalanceId	UUID	Identifier of the user cash balance account withdrawn from.
seatId	UUID	The seat identifier associated with the account.

❗️
Authorization required
This mutation requires the MAKE_INTERNAL_TRANSFER scope. Ensure your access token has been granted this scope before attempting to create a cash balance account.