> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.
# Depósito desde cuentas externas
depositCashBalance
Cuando estés listo para mover dinero a tu cuenta de Fluz, puedes depositar fondos en los siguientes tres saldos:
1. **Saldo en efectivo** - Un depósito regular de saldo en efectivo.
2. **Saldo de tarjeta de regalo** - Un depósito no retirable para saldo de tarjeta de regalo.
3. **Saldo de reserva** - Un depósito mantenido en saldo de reserva.
# Realizar un depósito
Para depositar fondos en uno de tus saldos de Fluz, usa la [mutación](https://storage.googleapis.com/fluz-public-docs/api-reference.html#mutation-depositCashBalance) `depositCashBalance`. Esta mutación acepta un objeto de entrada de tipo `DepositCashBalanceInput`, que te permite especificar los siguientes detalles:
1. **Amount:** **Obligatorio** - El monto que deseas depositar.
2. **idempotencyKey:** **Obligatorio** - Un UUID único generado por el cliente para asegurar que una solicitud se procese solo una vez.
3. **Funding Source:** El método de pago desde el cual se realizará el depósito (p. ej., cuenta bancaria, tarjeta de crédito o débito, PayPal). Para obtener el ID de tu fuente de fondos, usa la [consulta](https://storage.googleapis.com/fluz-public-docs/api-reference.html#query-getWallet) `getWallet`.
1. **`bankAccountId`** - Si quieres pagar con una cuenta bancaria, define el ID de la cuenta bancaria en la mutación `depositCashBalance`.
2. **`bankCardId`** - Si quieres pagar con una tarjeta bancaria, define el ID de la tarjeta bancaria en la mutación `depositCashBalance`.
3. **`paypalVaultID`** - Si quieres pagar con una cuenta de PayPal, define el ID de la cuenta de PayPal en la mutación `depositCashBalance`.
4. **Destino del depósito:** El saldo donde quieres depositar tus fondos. Las opciones disponibles para esto están definidas en el enumerador `CashBalanceDepositType`:
1. **`CASH_BALANCE`**
2. **`GIFT_CARD_BALANCE`**
3. **`RESERVE_BALANCE`**
5. **Merchant Category Code:** Aplica solo para **GIFT\_CARD\_BALANCE**. Un número de cuatro dígitos que clasifica un negocio por el tipo de productos o servicios que ofrece. Usa `getMccList` para obtener una lista de MCC válidos.
6. **`userCashBalanceId`** - Si se selecciona `CASH_BALANCE`, puedes especificar el saldo en efectivo (cuenta de gasto) al que depositar tus fondos.
7. *`memo`*\* - Si deseas adjuntar una nota a esta transacción, proporciona un memo de texto libre aquí. Máximo 255 caracteres.
8. **`transactionCategory`** - Si deseas categorizar esta transacción, proporciona un nombre de categoría. Las categorías se crean automáticamente en el primer uso y se reutilizan si se pasa el mismo nombre nuevamente.
9. **`attachmentId`** - Si deseas adjuntar un archivo a esta transacción, proporciona el ID devuelto por el endpoint de carga. Consulta [Agregar detalles de gastos](/features/add-expense-details). 📘 Consulta [Agregar detalles de gastos](/features/add-expense-details) para ver todos los detalles sobre cómo subir adjuntos y trabajar con memos y categorías.
## Ejemplo de solicitud
```graphql graphql theme={null}
mutation depositCashBalance($input: DepositCashBalanceInput!) {
depositCashBalance(input: $input) {
cashBalanceDeposits {
...CashBalanceDepositFragment
}
balances {
...UserBalancesFragment
}
}
}
```
## DepositCashBalanceInput
```json theme={null}
{
"idempotencyKey": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
"amount": 987.65,
"depositType": "GIFT_CARD_BALANCE",
"merchantCategoryCode": 1234,
"bankAccountId": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
"bankCardId": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
"paypalVaultId": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
"userCashBalanceId": "0347ade-2b69-55e6-4db0-5b5daddf45d22"
}
```
## Ejemplo de respuesta
```json theme={null}
{
"data": {
"depositCashBalance": {
"cashBalanceDeposits": [
{
"cashBalanceDepositId": "5f5c5b5f-4c4b-4e4e-9e9e-4f4f4f4f4f4f",
"depositDisplayId": "102370",
"depositAmount": "100.00",
"depositFee": "2.00",
"bankAccountId": "b2c3d4e5-f6a7-890b-c12d-34ef5678gh90",
"transactionDate": "2024-08-21T10:30:00Z",
"clearedDate": "2024-08-22T12:00:00Z",
"status": "COMPLETED",
"expectedClearedDate": "2024-08-22T12:00:00Z",
"cashBalanceDepositType": "CASH_BALANCE",
"cashBalanceSettlements": [
{
"cashBalanceSettlementId": "255f8245-02c7-4817-901e-15fe265f6968",
"cashBalanceDepositId": "255f8245-02c7-4817-901e-15fe265f6968",
"availabilityType": "INSTANT",
"status": "AVAILABLE"
}
]
}
],
"balances": {
"cashBalance": {
"availableBalance": "25.00",
"totalBalance": "25.00",
"pendingBalance": "25.00",
"lifetimeBalance": "25.00",
},
"rewardBalance": {
"availableBalance": "25.00",
"totalBalance": "25.00",
"lifetimeBalance": "25.00",
},
"giftCardCashBalance": {
"availableBalance": "25.00",
"totalBalance": "25.00",
"pendingBalance": "25.00",
"lifetimeBalance": "25.00",
}
}
}
}
}
```
# Respuesta del depósito
Una vez que inicies un depósito con la [mutación](https://storage.googleapis.com/fluz-public-docs/api-reference.html#mutation-depositCashBalance) `depositCashBalance`, recibirás una respuesta que proporciona detalles sobre el depósito.
| Field Name | Type | Description |
| :------------------ | :-------------------- | :------------------------------------------------------------------------------------------------------------- |
| cashBalanceDeposits | \[CashBalanceDeposit] | Lista de depósitos de saldo en efectivo realizados como parte de la mutación. |
| balances | UserBalances | Los saldos actuales del usuario, incluidos saldo en efectivo, saldo de recompensas y saldo de prepago de Fluz. |
El objeto `CashBalanceDeposit` contendrá información importante sobre el depósito que iniciaste.
| Field Name | Type | Description |
| :--------------------- | :------------------------ | :---------------------------------------------------------------------------------------------------------- |
| cashBalanceDepositId | UUID! | Identificador único para el depósito de saldo en efectivo. |
| depositDisplayId | String! | Identificador de visualización del depósito, destinado a fines de cara al usuario. |
| depositAmount | String! | El monto del depósito. |
| depositFee | String | Tarifa asociada con el depósito, si aplica. |
| bankCardId | UUID | Identificador de la tarjeta bancaria utilizada para el depósito. |
| bankAccountId | UUID | Identificador de la cuenta bancaria utilizada para el depósito. |
| paypalVaultId | UUID | Identificador del vault de PayPal utilizado para el depósito. |
| transactionDate | DateTime! | Fecha y hora en que se realizó la transacción. |
| clearedDate | DateTime | Fecha y hora en que el depósito se compensó, si aplica. |
| status | CashBalanceDepositStatus! | Estado actual del depósito. |
| expectedClearedDate | DateTime! | Fecha y hora estimadas para que el depósito se compense. |
| cashBalanceDepositType | CashBalanceDepositType! | Tipo del depósito de saldo en efectivo, incluyendo `CASH_BALANCE`,`GIFT_CARD_PREPAYMENT`,`RESERVE_BALANCE`. |
| cashBalanceSettlements | \[CashBalanceSettlement] | Detalles del tiempo de liquidación del depósito, incluyendo estado y tipo. |
> 📘 Ten en cuenta
>
> Los depósitos pueden liquidarse al instante o dentro de 2 a 5 días hábiles. Para aprender cómo se calculan los tiempos de liquidación, [lee este artículo.](https://help.fluz.app/en/articles/5773275-instant-access)