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

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 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. 📘 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

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": "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

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

📘 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.