---
title: "Manage funds to a specific wallet"
method: POST
path: "/v2/wallets/{walletId}:manage-funds"
tags: ["wallet"]
---

# Manage funds to a specific wallet

`POST /v2/wallets/{walletId}:manage-funds`

## Path parameters

- `walletId` string, required

## Request body

- WalletServiceManageFundsBody
  - `funds` V2Funds
    - `cardId` string — Id of the card from which the wallet is to be topped up or debited
    - `amount` string — The amount to add to or deduct from the 'current balance' for the wallet. The max total 'current balance' for the wallet is 999,999,999,999.999999
  - `idempotencyToken` string — A unique identifier to ensure the operation is idempotent. It's recommended to use a UUIDv4 for this purpose.

## Response `200`

A successful response.

- V2ManageFundsResponse
  - `walletBalance` V2WalletBalance
    - `currentBalance` string — The total amount currently present in the wallet.
    - `availableBalance` string — The amount in the wallet available for spending.
    - `cappedAvailableBalance` string — The remainder of the amount that the wallet is releasing to be spent for a day (daily budget limit) or a month (credit limit). If there are no capped spends set up on a wallet then this will just reflect the available balance. Any unspent amounts will roll over to the next day.

## Other responses

- `400` — There was a problem with input.
- `401` — Login failed or token not valid.
- `403` — Access denied due to insufficient permissions.
- `default` — An unexpected error response.

---

[API](https://skmtc.net/citrusad/apis/citrus-auth-api.md) · [All operations](https://skmtc.net/citrusad/apis/citrus-auth-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/citrusad/citrus-auth-api/revisions/a040003c7378/schema)