Transferencia entre cuentas de gasto

Mueve dinero entre dos de tus propias cuentas de gasto de Fluz: retira de una cuenta de gasto de origen y deposita en una cuenta de gasto de destino en una sola operación, usando la mutación transferInternalBalance.

Esto transfiere entre tus propias cuentas de gasto.Una cuenta de gasto es una cuenta de saldo en efectivo (el tipo UserCashBalance). Esta mutación mueve fondos de una de tus cuentas de gasto a otra. Para enviar fondos a un usuario de Fluz diferente, usa Transferir a otra billetera de Fluz en su lugar.

Transferir fondos entre cuentas de gasto

Para mover fondos de una cuenta de gasto a otra, usa la mutación transferInternalBalance. Recibe un objeto de entrada TransferInternalBalanceInput que identifica la cuenta de gasto de origen, la cuenta de gasto de destino y el monto.

TransferInternalBalanceInput

Campo	Tipo	Requerido	Descripción
amount	Float!	Sí	El monto a transferir desde la cuenta de gasto de origen a la cuenta de gasto de destino.
idempotencyKey	String!	Sí	Una cadena única generada por el cliente para garantizar el procesamiento idempotente de la solicitud. Si se envía la misma clave varias veces, solo se procesa la primera solicitud.
sourceUserCashBalanceId	UUID!	Sí	La cuenta de gasto de la cual se retirarán fondos.
destinationUserCashBalanceId	UUID!	Sí	La cuenta de gasto en la que se depositarán los fondos.

Ambos IDs deben ser de tus propias cuentas de gasto.

Usa Obtener cuentas de gasto para buscar el userCashBalanceId de cada cuenta de gasto. El origen y el destino deben ser dos cuentas de gasto diferentes, y la cuenta de origen debe tener suficiente saldo disponible para cubrir la transferencia.

Solicitud de ejemplo

GraphQL

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
    }
  }
}

Ejemplo de entrada

En este ejemplo, se mueven $6.00 desde la cuenta de gasto de origen hacia la cuenta de gasto de destino. JSON

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

Respuesta de ejemplo

Entender la respuesta

Una transferencia interna se registra como dos movimientos vinculados: un withdraw desde la cuenta de gasto de origen y un deposit en la cuenta de gasto de destino. La respuesta devuelve ambos.

Nombre del campo	Tipo	Descripción
cashBalanceDeposit	CashBalanceDeposit	El depósito realizado en la cuenta de gasto de destino.
withdraw	Withdraw	El retiro realizado desde la cuenta de gasto de origen.

cashBalanceDeposit

El objeto cashBalanceDeposit contiene detalles sobre el depósito en la cuenta de gasto de destino.

Nombre del campo	Tipo	Descripción
cashBalanceDepositId	UUID!	Identificador único del depósito del saldo en efectivo.
depositDisplayId	String!	Identificador de visualización del depósito, destinado a interfaces de 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 del saldo en efectivo, incluyendo CASH_BALANCE, GIFT_CARD_PREPAYMENT, RESERVE_BALANCE.
cashBalanceSettlements	[CashBalanceSettlement]	Detalles de tiempo de compensación para el depósito, incluyendo estado y tipo.

withdraw

El objeto withdraw contiene detalles sobre el retiro desde la cuenta de gasto de origen.

Nombre del campo	Tipo	Descripción
withdrawId	UUID!	Identificador único del retiro.
amount	String!	El monto retirado.
processingFee	String!	Tarifa cobrada por procesar el retiro.
chargedFee	String!	Tarifa cobrada al usuario por el retiro.
status	String!	Estado interno del retiro.
displayStatus	String!	Estado de visualización amigable para el usuario del retiro.
withdrawSource	WithdrawSource!	El saldo de origen desde el cual se retiraron los fondos.
submissionDate	DateTime!	Fecha y hora en que se envió el retiro.
createdAt	DateTime!	Fecha y hora en que se creó el retiro.
updatedAt	DateTime!	Fecha y hora de la última actualización del retiro.
transactionLogId	UUID	Identificador del registro de transacción asociado.
externalTransactionId	String	Identificador de transacción externo del gateway de pago (para ACH).
payoutId	String	Identificador de pago del gateway de pago (para PayPal/Venmo).
emailAddress	String	Dirección de correo electrónico asociada con el retiro.
bankAccountId	UUID	Identificador de la cuenta bancaria utilizada (si aplica).
userCashBalanceId	UUID	Identificador de la cuenta de gasto de origen desde la que se retiraron los fondos.
seatId	UUID	El identificador del asiento asociado con la cuenta.

Se requiere autorizaciónEsta mutación requiere el alcance MAKE_INTERNAL_TRANSFER. Asegúrate de que tu token de acceso tenga concedido este alcance antes de intentar una transferencia interna entre cuentas de gasto.

​Transferir fondos entre cuentas de gasto

​TransferInternalBalanceInput

​Ambos IDs deben ser de tus propias cuentas de gasto.

​Solicitud de ejemplo

​Ejemplo de entrada

​Respuesta de ejemplo

​Entender la respuesta

​cashBalanceDeposit

​withdraw

Transferir fondos entre cuentas de gasto

TransferInternalBalanceInput

Ambos IDs deben ser de tus propias cuentas de gasto.

Solicitud de ejemplo

Ejemplo de entrada

Respuesta de ejemplo

Entender la respuesta

cashBalanceDeposit

withdraw