Solicitar Aprobación de Transferencia Interna

requestInternalTransfer Envía una solicitud de aprobación de un gerente para mover fondos entre dos cuentas de gasto dentro de la misma cuenta de Fluz. Cuando se aprueba, Fluz ejecuta la transferencia interna. Esto es diferente de las transferencias entre cuentas. Usa requestAccountTransfer cuando muevas fondos entre cuentas de Fluz. Consulta Solicitar Aprobación de Transferencia entre Cuentas.

Alcances

Acción	Scope
Crear solicitud	`REQUEST_INTERNAL_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 entre cuentas comparten el mismo approvalType y approvalCode. Usa la mutación de la solicitud original o inspecciona el payload de la aprobación en tu integración para distinguirlas.

Crear una Solicitud

RequestInternalTransferInput

Campo	Tipo	Requerido	Descripción
`amount`	Float	Sí	Monto a transferir. Debe ser mayor que cero
`sourceUserCashBalanceId`	UUID	Sí	Cuenta de gasto desde la cual retirar
`destinationUserCashBalanceId`	UUID	Sí	Cuenta de gasto a la cual depositar

El origen y el destino deben ser cuentas de gasto diferentes.

Mutación de Ejemplo

mutation {
  requestInternalTransfer(
    input: {
      amount: 50.00
      sourceUserCashBalanceId: "6d1b4b19-deef-42f5-80d7-ec34804ce090"
      destinationUserCashBalanceId: "bb584e49-d030-4a6e-a5a9-1c34368cbaed"
    }
  ) {
    success
    messageId
    error {
      code
      message
    }
  }
}

Respuesta de Ejemplo

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

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 transfiere fondos entre las cuentas de gasto especificadas.

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 una solicitud es rechazada.

​Alcances

​Identificadores de Webhook

​Crear una Solicitud

​RequestInternalTransferInput

​Mutación de Ejemplo

​Respuesta de Ejemplo

​Aprobar una Solicitud

​Rechazar una Solicitud