> ## Documentation Index
> Fetch the complete documentation index at: https://docs.fluz.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Descripción general

Una **fuente de fondos** (también llamada método de pago) es cómo los usuarios pagan transacciones en Fluz: compras de tarjetas de regalo, recargas de tarjetas virtuales, depósitos a la billetera y más.

Antes de completar cualquier transacción, el usuario debe tener al menos una fuente de fondos registrada. **Siempre se debe agregar una tarjeta bancaria como método de pago de respaldo**, incluso cuando el usuario pretenda pagar con su cuenta bancaria u otro método.

***

## Fuentes de fondos compatibles

Fluz admite cuatro tipos de fuentes de fondos:

| Tipo                                            | Agregar vía API | Agregar vía App / Web | Comisiones                        | Mejor cashback    |
| ----------------------------------------------- | --------------- | --------------------- | --------------------------------- | ----------------- |
| **Cuenta bancaria (ACH)**                       | ✗               | ✓                     | Ninguna                           | ✓ Tarifa completa |
| **Tarjeta bancaria** (débito/crédito/prepagada) | ✓               | ✓                     | Débito: –1% · Crédito/PayPal: –3% | Débito > Crédito  |
| **PayPal / Apple Pay / Google Pay**             | ✗               | ✓                     | –3%                               | Menor             |
| **Saldo Fluz**                                  | —               | —                     | Ninguna                           | Estándar          |

> 💡 **Las cuentas bancarias no tienen comisiones de procesamiento y obtienen la tasa de cashback más alta.** Las tarjetas de débito son la siguiente mejor opción. Las tarjetas de crédito, PayPal, Apple Pay y Google Pay tienen una comisión de procesamiento que reduce la tasa efectiva de cashback.

***

## Tasa de cashback por fuente de fondos

Usando una **tasa de cashback del comercio de 4%** como ejemplo en una compra de tarjeta de regalo de \$200:

```text theme={null}
ACH / Bank Account    → 4.0%  →  $8.00
Debit Card            → 3.0%  →  $6.00  (–1% processing fee)
Credit Card           → 1.0%  →  $2.00  (–3% processing fee)
PayPal / Apple Pay    → 1.0%  →  $2.00  (–3% processing fee)
```

***

## Qué se puede hacer vía API vs. App / Web

```mermaid theme={null}
flowchart LR
    subgraph API["🔌 API"]
        A1[Add Bank Card\naddBankCard mutation]
        A2[Update Bank Card\nnickname / MCC]
        A3[Delete Bank Card]
        A4[Read all funding sources\ngetWallet query]
    end

    subgraph Web["🌐 App / Web Portal Only"]
        W1[Add Bank Account\nvia Plaid Link]
        W2[Remove Bank Account]
        W3[Add PayPal]
        W4[Add Apple Pay / Google Pay]
        W5[Set primary / preferred /\nbackup payment method]
    end
```

> 🚧 **Las tarjetas bancarias son la única fuente de fondos que se puede agregar vía API.** Toda la demás gestión de fuentes de fondos — cuentas bancarias, PayPal, Apple Pay, Google Pay y preferencias de método de pago — debe realizarse a través de la app o el portal web de Fluz.

***

## Cuenta bancaria

Las cuentas bancarias se vinculan mediante **Plaid** y liquidan vía ACH. No tienen comisiones y ganan la tasa completa de cashback del comercio.

**Agregado vía: Solo app o portal web.**

![Adding a bank account on the Fluz app](https://downloads.intercomcdn.com/i/o/836799999/6f3ab32e045b7011dd3bd0fb/How+to+manage+and+select+a+funding+source.gif)

*Para agregar: Menú → Fuentes de fondos → Agregar nuevo → Cuenta bancaria → seguir las indicaciones de Plaid.*

> 💡 Todas las cuentas bajo un inicio de sesión bancario vinculado se conectan, incluidas las cuentas de ahorro. Los usuarios deben eliminar las cuentas de ahorro después de vincular — la mayoría de los bancos no permiten pagos desde cuentas de ahorro.

***

## Tarjeta bancaria

Las tarjetas bancarias (débito, crédito o prepagadas) se pueden agregar mediante la **API** o a través de la app y el portal web.

**Agregado vía:** `addBankCard `**mutation (API) o app / portal web.**

![Adding a bank card on the Fluz app](https://downloads.intercomcdn.com/i/o/836809654/93aa3bc1b082cff44ef2a70c/How+to+manage+and+select+a+funding+source.gif)

*Para agregar en la web: Menú → Cuentas y tarjetas → Tarjetas bancarias → Agregar nuevo → ingresar datos de la tarjeta y dirección de facturación.*

Las tarjetas bancarias admiten las siguientes operaciones mediante la API:

* **Agregar** — `addBankCard` (requiere alcance `MANAGE_PAYMENT`)
* **Actualizar apodo** — `updateBankCardNickname`
* **Actualizar MCC preferido** — `updateBankCardPreferredMerchantCategoryCode`
* **Eliminar** — `deleteBankCard` (establece el estado en `INACTIVE`)

> ❗️ **Se debe agregar una tarjeta bancaria como método de pago de respaldo antes de completar cualquier transacción.** Cuando un usuario paga vía ACH, se puede colocar una retención temporal en la tarjeta de respaldo por el monto de la transacción. Si el pago ACH se liquida, la retención se libera dentro de 1 a 7 días hábiles. Si no se liquida, se cobra la tarjeta de respaldo.

***

## PayPal / Apple Pay / Google Pay

Las billeteras digitales se pueden agregar solo a través de la app o el portal web. Tienen una comisión de procesamiento de –3% aplicada a la tasa efectiva de cashback, igual que las tarjetas de crédito.

**Agregado vía: Solo app o portal web. No disponible vía API.**

> 💡 Algunos comercios restringen los métodos de pago que aceptan. Un comercio puede aceptar solo ACH y débito, y bloquear tarjetas de crédito y billeteras digitales. Esto se refleja en el campo `blockedPaymentTypes` devuelto por `getWallet`.

***

## Lectura de fuentes de fondos vía API

La consulta `getWallet` devuelve todas las fuentes de fondos vinculadas a la cuenta de un usuario, sus estados actuales y cualquier tipo de pago bloqueado.

```graphql theme={null}
query getWallet {
  getWallet {
    bankCards { bankCardId cardType lastFourDigits cardStatus }
    bankAccounts { bankAccountId type status lastFour }
    paypalAccounts { paypalVaultId status email }
    blockedPaymentTypes
    balances {
      rewardsBalance { availableBalance }
      cashBalance { availableBalance }
    }
  }
}
```

Consulta [Ver fuentes de fondos](/features/view-funding-sources) para la referencia completa de campos.

<br />
