Fuente de fondos principal y de respaldo

​

Cómo funciona el fondeo

1. Cuando un usuario paga vía ACH, puede colocarse una retención temporal en la tarjeta de respaldo por el monto de la transacción.
2. Si el pago ACH se liquida, la retención se libera dentro de 1–7 días hábiles.
3. Si el pago ACH no se liquida, entonces se cobra la tarjeta de respaldo.

❗️ Se debe registrar una tarjeta de respaldo antes de que una transacción pueda completarse Fluz requiere una tarjeta bancaria válida como respaldo para que una transacción pueda liquidarse si falla la fuente de fondos principal. Sin una, las transacciones que dependen de ACH no pueden iniciarse.

​

Configuración de principal y respaldo

​

Vía API

📘 Autenticación y alcances Estas operaciones requieren un token de acceso de usuario. Las lecturas (getDefaultFundingSource) usan el alcance LIST_PAYMENT; los cambios (setPrimaryFundingSource, setBackupFundingSource) usan MANAGE_PAYMENT.

​

Leer la fuente de fondos predeterminada actual

query {
  getDefaultFundingSource {
    primary { bankAccountId accountName status lastFour }
    backup  { bankCardId lastFourDigits cardType cardStatus }
  }
}

{
  "data": {
    "getDefaultFundingSource": {
      "primary": {
        "bankAccountId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "accountName": "Chase Total Checking",
        "status": "ENABLED",
        "lastFour": "6789"
      },
      "backup": {
        "bankCardId": "16fd2706-8baf-433b-82eb-8c7fada847da",
        "lastFourDigits": "4242",
        "cardType": "CREDIT",
        "cardStatus": "ACTIVE"
      }
    }
  }
}

👍 Una llamada, dos lecturas El mismo objeto DefaultFundingSource también se devuelve dentro de getWallet { defaultFundingSource { … } } — así puedes leer la selección actual en la misma llamada que usas para listar el contenido de la billetera.

​

Configurar la fuente de fondos principal (una cuenta bancaria)

mutation {
  setPrimaryFundingSource(input: { bankAccountId: "d290f1ee-6c54-4b01-90e6-d701748f0851" }) {
    primary { bankAccountId accountName }
    backup  { bankCardId lastFourDigits }
  }
}

{
  "data": {
    "setPrimaryFundingSource": {
      "primary": {
        "bankAccountId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "accountName": "Chase Total Checking"
      },
      "backup": {
        "bankCardId": "16fd2706-8baf-433b-82eb-8c7fada847da",
        "lastFourDigits": "4242"
      }
    }
  }
}

​

Configurar la fuente de fondos de respaldo (una tarjeta bancaria)

mutation {
  setBackupFundingSource(input: { bankCardId: "16fd2706-8baf-433b-82eb-8c7fada847da" }) {
    primary { bankAccountId accountName }
    backup  { bankCardId lastFourDigits }
  }
}

{
  "data": {
    "setBackupFundingSource": {
      "primary": {
        "bankAccountId": "d290f1ee-6c54-4b01-90e6-d701748f0851",
        "accountName": "Chase Total Checking"
      },
      "backup": {
        "bankCardId": "16fd2706-8baf-433b-82eb-8c7fada847da",
        "lastFourDigits": "4242"
      }
    }
  }
}

📘 Ambas mutaciones devuelven el DefaultFundingSource completo de la cuenta Cada mutación devuelve principal + respaldo después del cambio, por lo que una sola llamada actualiza un rol y confirma el estado resultante.

​

Reglas de validación

• El bankAccountId debe ser una cuenta bancaria vinculada a la cuenta y habilitada; el bankCardId debe ser una tarjeta bancaria en la cuenta y activa.
• La principal debe ser una cuenta bancaria y la de respaldo una tarjeta bancaria: un desajuste es rechazado.
• Configurar un rol reemplaza la selección anterior de la cuenta (una principal, una de respaldo a la vez).

​

Errores

{
  "errors": [
    {
      "message": "Please verify that your account is active and up-to-date and try again.",
      "extensions": {
        "errorName": "InvalidBankAccount",
        "code": "BA-0001",
        "statusCode": 400,
        "userFriendly": true
      }
    }
  ],
  "data": {
    "setPrimaryFundingSource": null
  }
}

​

En la app / web

1. Abre Accounts and Cards desde el menú de la cuenta (o ve a /accounts-and-cards).
2. En la sección Default funding source en la parte superior de la página:
   • Selecciona Manage preferred account para elegir la cuenta bancaria usada como fuente de fondos predeterminada.
   • Selecciona Manage backup card para elegir la tarjeta bancaria que se cobra si no se puede usar la cuenta preferida.
3. Tu selección se guarda de inmediato.

1. Abre el menú y toca Accounts and Cards.
2. En Default funding source, toca Manage preferred account o Manage backup card.
3. Elige entre tus fuentes de fondos vinculadas. Tu selección se guarda de inmediato.

​

Qué se puede hacer vía API vs. app / web

​

Elegibilidad y notas

• El método de pago principal debe ser una cuenta bancaria vinculada; el de respaldo debe ser una tarjeta bancaria.
• Las cuentas empresariales deben completar la verificación KYB antes de poder configurar fuentes de fondos — y, por lo tanto, la fuente de fondos predeterminada.
• Algunas fuentes de fondos pueden estar restringidas para comercios específicos o por límites de la cuenta y no serán seleccionables como predeterminadas.

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