Solicitar Aprobación de Transferencia de Cuenta

requestAccountTransfer Envía una solicitud de aprobación de gerente para una transferencia de cuenta a cuenta. Cuando se aprueba, Fluz ejecuta la transferencia utilizando la misma semántica que createTransfer. Usa esto cuando un usuario o una aplicación necesiten la firma de un gerente antes de mover fondos entre cuentas de Fluz. Para transferencias entre cuentas de gasto dentro de la misma cuenta, usa requestInternalTransfer en su lugar.

Alcances

Acción	Scope
Crear solicitud	`REQUEST_ACCOUNT_TRANSFER`
Listar solicitudes	`LIST_APPROVALS`
Aprobar o rechazar	`MANAGE_APPROVALS`

Identificadores de Webhook

Campo	Valor
`approvalType`	`PAYOUT`
`approvalCode`	`500402`

Eventos de webhook: APPROVAL_CREATE, APPROVAL_APPROVE, APPROVAL_DECLINE y APPROVAL_HANDLER_ERROR en caso de falla de ejecución.

Las transferencias internas y las transferencias de cuenta comparten el mismo approvalType y approvalCode. Usa la mutación de solicitud original o inspecciona el payload de la aprobación en tu integración para distinguirlas.

Crear una Solicitud

La entrada refleja Transferir a otra billetera de Fluz. El remitente se determina a partir de la autenticación; el destino y las fuentes de fondos siguen las mismas reglas que createTransfer.

RequestAccountTransferInput

Campo	Tipo	Requerido	Descripción
`idempotencyKey`	UUID	Sí	Clave única para evitar transferencias duplicadas al aprobar
`amount`	Float	Sí	Monto a transferir. Debe ser mayor que cero
`destination`	TransferDestination	Depende	Cuenta receptora. Requerida para Basic Auth; opcional para Bearer (predetermina a tu aplicación)
`bankCardId`	UUID	No	Fondos de una tarjeta bancaria vinculada. Solo token Bearer
`bankAccountId`	UUID	No	Fondos vía ACH. Solo token Bearer
`paypalVaultId`	UUID	No	Fondos desde PayPal. Solo token Bearer
`memo`	String	No	Memo de la transacción
`transactionCategory`	String	No	Etiqueta de categoría; se crea automáticamente en el primer uso
`attachmentId`	String	No	ID de un adjunto de transacción cargado previamente

TransferDestination

Campo	Tipo	Descripción
`accountId`	UUID	ID de la cuenta de Fluz receptora
`externalReferenceId`	String	ID de referencia externa del destinatario desde tu sistema
`userCashBalanceId`	UUID	Cuenta de gasto de destino opcional en la cuenta receptora

Proporciona accountId o externalReferenceId, no ambos.

Notas de Autenticación

Método	Remitente	Notas
Bearer token	Usuario autenticado	Se permiten fuentes de fondos; destino opcional (predetermina a tu aplicación)
Basic Auth	Tu aplicación	Destino requerido; no se permiten fuentes de fondos

Mutación de Ejemplo — Usuario a Aplicación

mutation {
  requestAccountTransfer(
    input: {
      idempotencyKey: "550e8400-e29b-41d4-a716-446655440000"
      amount: 100.00
    }
  ) {
    success
    messageId
    error {
      code
      message
    }
  }
}

Mutación de Ejemplo — Aplicación a Usuario

mutation {
  requestAccountTransfer(
    input: {
      idempotencyKey: "550e8400-e29b-41d4-a716-446655440001"
      amount: 50.00
      destination: {
        accountId: "c3d4e5f6-a7b8-9012-cdef-345678901234"
      }
    }
  ) {
    success
    messageId
    error {
      code
      message
    }
  }
}

Respuesta de Ejemplo

{
  "data": {
    "requestAccountTransfer": {
      "success": true,
      "messageId": "1234567890"
    }
  }
}

El idempotencyKey se conserva y se utiliza cuando la transferencia se ejecuta tras la aprobación.

Aprobar una Solicitud

Llama a approveApprovalRequest con el approvalId. Requiere MANAGE_APPROVALS.

mutation {
  approveApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}

Al aprobar, Fluz ejecuta la transferencia de cuenta.

Rechazar una Solicitud

Llama a declineApprovalRequest con el approvalId. Requiere MANAGE_APPROVALS.

mutation {
  declineApprovalRequest(approvalId: "07df5653-43a8-4532-9881-3ab5857bbe12") {
    success
    approvalId
    action
  }
}

No se ejecuta ninguna transferencia cuando se rechaza una solicitud.

​Alcances

​Identificadores de Webhook

​Crear una Solicitud

​RequestAccountTransferInput

​TransferDestination

​Notas de Autenticación

​Mutación de Ejemplo — Usuario a Aplicación

​Mutación de Ejemplo — Aplicación a Usuario

​Respuesta de Ejemplo

​Aprobar una Solicitud

​Rechazar una Solicitud