Saltar al contenido principal
Las transferencias de cuenta a cuenta mueven fondos entre dos cuentas de Fluz utilizando la mutación createTransfer. A diferencia de una transferencia interna — que mueve dinero entre dos de tus propias cuentas de gasto — una transferencia de cuenta a cuenta envía dinero a una cuenta de Fluz diferente: la de uno de tus usuarios, tu aplicación o entre dos de tus usuarios. Cada transferencia tiene un flujo de dos pasos: primero identifica al destinatario, luego crea la transferencia.
No es lo mismo que una transferencia interna.Para mover dinero entre tus propias cuentas de gasto, usa Transferir fondos internamente. Las transferencias de cuenta a cuenta son para mover fondos a una cuenta de Fluz separada.

​
Las tres direcciones de transferencia

La misma mutación createTransfer admite tres direcciones. Cuál estás realizando se determina por tu método de autenticación y si proporcionas un destination.
Las transferencias de cuenta a cuenta requieren una aplicación pública.Las transferencias con Basic Auth (aplicación como remitente) requieren que tu aplicación esté en estado ACTIVE. Las aplicaciones personales no pueden enviar vía Basic Auth. El destinatario también debe ser un usuario registrado de tu aplicación.

​
Paso 1 — Buscar al destinatario

Antes de enviar, resuelve al destinatario a un accountId utilizando las queries de búsqueda (ambas requieren el scope QUERY_RECIPIENT):
  • lookupUser — encuentra a una persona por número de teléfono (formato E.164) o correo electrónico.
  • lookupBusiness — encuentra a una empresa por razón social (coincidencia exacta sin distinción de mayúsculas; busca tanto el nombre registrado como el nombre comercial/DBA).
Si ya almacenaste el accountId de Fluz del destinatario — o le asignaste un externalReferenceId cuando lo creaste — puedes omitir la búsqueda y pasar ese identificador directamente en el Paso 2. Consulta Búsqueda de destinatario de transferencia de billetera para entradas, respuestas y códigos de error.

​
Paso 2 — Crear la transferencia

Envía los fondos con la mutación createTransfer. Como mínimo proporcionas un idempotencyKey y un amount; el destination y la fuente de fondos dependen de la dirección.
  • Identifica al destinatario por accountId o por el externalReferenceId que asignaste — proporciona uno, no ambos. Opcionalmente apunta a un userCashBalanceId específico en la cuenta del destinatario.
  • Fondea la transferencia desde el saldo en efectivo del remitente por defecto, o (solo Bearer token) desde un bankCardId, bankAccountId o paypalVaultId vinculados. Solo una fuente de fondos por solicitud.
  • Anota la transferencia con un memo, transactionCategory o attachmentId opcionales.
Las transferencias con Bearer token (enviadas por el usuario) requieren el scope MAKE_PAYOUT_TRANSFER_SEND. Consulta Transferir a otra billetera de Fluz para la referencia completa de entrada, ejemplos para cada dirección y manejo de errores.

​
Idempotencia

Cada transferencia debe incluir un idempotencyKey único generado por el cliente. Si la misma clave se envía más de una vez, la API devuelve el resultado de la solicitud original en lugar de crear una transferencia duplicada. Las claves son válidas por 10 minutos.

​
Requisitos de un vistazo

¿Quieres saber más? Habla con nuestros expertos para obtener más información o solicitar una demostración.