depositCashBalance Cuando estés listo para mover dinero a tu cuenta de Fluz, puedes depositar fondos en los siguientes tres saldos:

Saldo en efectivo - Un depósito regular de saldo en efectivo.
Saldo de tarjeta de regalo - Un depósito no retirable para saldo de tarjeta de regalo.
Saldo de reserva - Un depósito mantenido en el saldo de reserva.

Realizar un depósito

Los depósitos requieren el scope MAKE_DEPOSIT en el token de acceso. Para depositar fondos en uno de tus saldos de Fluz, usa la mutación depositCashBalance. Esta mutación acepta un objeto de entrada de tipo DepositCashBalanceInput, que te permite especificar los siguientes detalles:

Amount: Obligatorio - El monto que deseas depositar.
idempotencyKey: Obligatorio - Un UUID único generado por el cliente para asegurar que una solicitud se procese solo una vez.
Funding Source: El método de pago desde el cual se hará el depósito (por ejemplo, cuenta bancaria, tarjeta de crédito o débito, PayPal). Para obtener el ID de tu fuente de fondos, usa la consulta getWallet.
1. bankAccountId - Si deseas pagar con una cuenta bancaria, define el ID de la cuenta bancaria en la mutación depositCashBalance.
2. bankCardId - Si deseas pagar con una tarjeta bancaria, define el ID de la tarjeta bancaria en la mutación depositCashBalance.
3. paypalVaultID - Si deseas pagar con una cuenta de PayPal, define el ID de la cuenta de PayPal en la mutación depositCashBalance.
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
Código de categoría del comercio (MCC): Solo aplica 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.
userCashBalanceId - Si se selecciona CASH_BALANCE, puedes especificar el saldo en efectivo (cuenta de gasto) al cual depositar tus fondos.
memo* - Si deseas adjuntar una nota a esta transacción, proporciona un memo de texto libre aquí. Máximo 255 caracteres.
transactionCategory - Si deseas categorizar esta transacción, proporciona un nombre de categoría. Las categorías se crean automáticamente al primer uso y se reutilizan si se vuelve a enviar el mismo nombre.
attachmentId - Si deseas adjuntar un archivo a esta transacción, proporciona el ID devuelto por el endpoint de carga. Consulta Agregar detalles de gastos. 📘 Consulta Agregar detalles de gastos para ver todos los detalles sobre cómo subir adjuntos y trabajar con memos y categorías.

Ejemplo de solicitud

graphql

mutation depositCashBalance($input: DepositCashBalanceInput!) {
  depositCashBalance(input: $input) {
    cashBalanceDeposits {
      ...CashBalanceDepositFragment
    }
    balances {
      ...UserBalancesFragment
    }
  }
}

DepositCashBalanceInput

{
  "idempotencyKey": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
  "amount": 987.65,
  "depositType": "GIFT_CARD_BALANCE",
  "merchantCategoryCode": 1234,
  "bankAccountId": "0285c162-fb2f-4c32-b076-29166471f570",
  "bankCardId": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
  "paypalVaultId": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
  "userCashBalanceId": "0347adef-2b69-45e6-8db0-5b5daddf45d2"
}

Ejemplo de respuesta

{
  "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",
        }
      }
    }
  }
}

Depósitos con tarjeta de débito

Un depósito financiado por una tarjeta de débito puede procesarse como una transacción de financiamiento de cuenta (AFT) — un tipo de transacción de la red de tarjetas diseñada para mover fondos a una cuenta. Fluz la aplica automáticamente donde esté disponible; no hay un campo para solicitarla. Lo que cambia para ti es la tarifa. AFT aplica solo cuando se cumplen todas las siguientes condiciones:

La fuente de fondos es un bankCardId, y el cardType de la tarjeta es DEBIT.
depositType es CASH_BALANCE. Los depósitos a GIFT_CARD_BALANCE y RESERVE_BALANCE nunca usan AFT.
La tarjeta es elegible para AFT.

Las tarjetas bancarias CREDIT y PREPAID nunca usan AFT, y tampoco las cuentas bancarias (bankAccountId) ni PayPal (paypalVaultId). A estas se les cobra la tarifa estándar para su método de pago; este es un resultado normal, no un error.

Tarifas en depósitos con tarjeta de débito

A las tarjetas elegibles para AFT se les cobra una tarifa específica de AFT. A las tarjetas que no son elegibles para AFT se les cobra la tarifa estándar de tarjeta de débito; este es un resultado normal, no un error. Debido a que las dos tarifas difieren, lee depositFee de la respuesta en lugar de calcular la tarifa del lado del cliente.

Elegibilidad de la tarjeta

Si una tarjeta admite AFT es una propiedad de la propia tarjeta, no algo que configures. La elegibilidad se evalúa cuando se envía el depósito.

La elegibilidad no está disponible por adelantado y no se aplica a los retiros.No hay una consulta que informe si una tarjeta admite AFT: esto se refleja en la tarifa del primer depósito hecho con esa tarjeta. La elegibilidad para depósito y retiro también es independiente, por lo que una tarjeta desde la que un usuario puede depositar no es necesariamente una tarjeta a la que puedas enviar un retiro. Consulta Retirar a cuenta externa.

Maneja estos códigos de rechazo en depósitos con tarjeta de débito:

Código	Significado	Qué hacer
`HN-0125`	Esta tarjeta no es elegible para transferencias de financiamiento de cuenta (AFT).	Pídele al usuario una fuente de fondos diferente.
`PG-0003`	El depósito no pudo procesarse para esta tarjeta en este momento.	Reintenta más tarde o recurre a otra fuente de fondos.
`BC-0004`	La tarjeta fue rechazada por el emisor.	Muestra el mensaje; el usuario debe contactar a su banco o intentar con otra tarjeta.

Mantén una fuente de fondos alternativa disponible en tu interfaz para que una tarjeta no elegible o rechazada no bloquee el flujo.

Respuesta del depósito

Una vez que inicies un depósito con la mutación depositCashBalance, recibirás una respuesta con detalles sobre el depósito.

Nombre del campo	Tipo	Descripción
cashBalanceDeposits	[CashBalanceDeposit]	Lista de depósitos de saldo en efectivo realizados como parte de la mutación.
balances	UserBalances	Los saldos actuales del usuario, incluyendo 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.

Nombre del campo	Tipo	Descripción
cashBalanceDepositId	UUID!	Identificador único para el depósito de saldo en efectivo.
depositDisplayId	String!	Identificador para mostrar del depósito, destinado a fines de cara al usuario.
depositAmount	String!	El monto del depósito.
depositFee	String	Tarifa asociada al 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 previstas para que el depósito se compense.
cashBalanceDepositType	CashBalanceDepositType!	Tipo del depósito de saldo en efectivo: `CASH_BALANCE`, `GIFT_CARD_BALANCE` o `RESERVE_BALANCE`.
cashBalanceSettlements	[CashBalanceSettlement]	Detalles del tiempo de compensación del depósito, incluyendo estado y tipo.

📘 Ten en cuenta Los depósitos pueden compensarse al instante o dentro de 2 a 5 días hábiles. Para aprender cómo se calculan los tiempos de compensación, lee este artículo.

Funciones

Depósito desde cuentas externas

Realizar un depósito

Ejemplo de solicitud

DepositCashBalanceInput

Ejemplo de respuesta

Depósitos con tarjeta de débito

Tarifas en depósitos con tarjeta de débito

Elegibilidad de la tarjeta

Respuesta del depósito

​Realizar un depósito

​Ejemplo de solicitud

​DepositCashBalanceInput

​Ejemplo de respuesta

​Depósitos con tarjeta de débito

​Tarifas en depósitos con tarjeta de débito

​Elegibilidad de la tarjeta

​Respuesta del depósito

Realizar un depósito

Ejemplo de solicitud

DepositCashBalanceInput

Ejemplo de respuesta

Depósitos con tarjeta de débito

Tarifas en depósitos con tarjeta de débito

Elegibilidad de la tarjeta

Respuesta del depósito