Pagos externos

​

Descripción general

• Paga a cualquier persona con una cuenta bancaria de EE. UU. El destinatario solo necesita un número de ruta y un número de cuenta. No tiene que registrarse en Fluz.
• Paga desde tu saldo de Fluz. Los fondos provienen de uno de los saldos en efectivo de la cuenta, por lo que no hay un paso de fondeo aparte.
• Seguro de reintentar. Cada pago incluye una clave de idempotencia, por lo que un reintento de red nunca envía el dinero dos veces.
• Costo claro desde el inicio. La respuesta muestra la comisión y el total debitado del saldo.

1. Guarda la cuenta bancaria del destinatario como beneficiario con createExternalPayee.
2. Llama a createExternalPayout con el beneficiario, el saldo en efectivo de origen y el monto.
3. Fluz debita el saldo en efectivo de inmediato y devuelve el pago con el estado PENDING.
4. El dinero se envía al banco del destinatario en el siguiente archivo ACH estándar.

• createExternalPayout - Enviar dinero a un beneficiario externo

​

createExternalPayout

​

Mutación (CreateExternalPayoutInput)

createExternalPayout(input: CreateExternalPayoutInput!): ExternalPayoutResult

​

Entrada

​

Respuesta (ExternalPayoutResult)

​

Ejemplo

mutation {
  createExternalPayout(
    input: {
      idempotencyKey: "550e8400-e29b-41d4-a716-446655440020"
      externalPayeeId: "3f1c2b7e-8d4a-4c1e-9f2a-6b5d4e3c2a10"
      sourceCashBalanceId: "aaaaaaaa-bbbb-4ccc-8ddd-eeeeeeeeeeee"
      amount: 100.00
    }
  ) {
    transferId
    externalPayeeId
    amount
    fee
    totalDebited
    status
  }
}

{
  "data": {
    "createExternalPayout": {
      "transferId": "7c9e6679-7425-40de-944b-e07fc1f90ae7",
      "externalPayeeId": "3f1c2b7e-8d4a-4c1e-9f2a-6b5d4e3c2a10",
      "amount": 100,
      "fee": 1.5,
      "totalDebited": 101.5,
      "status": "PENDING"
    }
  }
}

{
  "errors": [
    {
      "message": "The sender does not have sufficient balance to complete this transfer.",
      "extensions": { "code": "PT-0007" }
    }
  ]
}

​

Códigos de error

​

Estado del pago

​

Notas importantes

​

Fondos y plazos

• El saldo en efectivo se debita por totalDebited en cuanto la mutación se completa correctamente.
• Los pagos usan ACH estándar. El ACH del mismo día y el ACH acelerado no están disponibles.
• El dinero sale de Fluz en el siguiente archivo ACH. El tiempo que tarda en llegar al destinatario depende del procesamiento ACH y del banco del destinatario.

​

Comisiones y límites

• Fluz fija la comisión y se suma al amount. El destinatario recibe el amount completo.
• Los límites diario, semanal, mensual y anual, además de los montos mínimo y máximo, se aplican por cuenta. Cuando se alcanza un límite, la solicitud falla con un código de error PT-.
• Los fondos que aún se están liberando no se pueden enviar.

​

Idempotencia

• Envía un UUID nuevo por cada pago nuevo.
• Si una solicitud agota el tiempo de espera, reinténtala con la misma clave y la misma entrada. Obtienes el resultado original y el dinero no se envía dos veces.
• Se rechaza una clave usada con un monto, un saldo de origen o un beneficiario distintos.
• Las claves de idempotencia se comparten entre todos los tipos de transferencia. Una clave que ya se usó para otro tipo de transferencia no se puede reutilizar aquí.

​

Beneficiarios

• El beneficiario debe estar activo en la cuenta. No se puede pagar a beneficiarios eliminados.
• Algunas cuentas bancarias no pueden recibir pagos. En ese caso, la solicitud falla con ARG-0001.

​

Pagos devueltos

• Si el banco del destinatario rechaza el pago, por ejemplo porque la cuenta está cerrada, el dinero se devuelve al saldo en efectivo de origen.