Gestionar fuentes de fondos vinculadas

​

Fuentes de fondos compatibles

💡 Las cuentas bancarias no tienen tarifas 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 tarifa de procesamiento que reduce la tasa de cashback efectiva.

​

Tasa de cashback por fuente de fondos

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

🚧 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

💡 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

• Agregar — addBankCard (requiere alcance MANAGE_PAYMENT)
• Actualizar apodo — updateBankCardNickname
• Actualizar MCC preferido — updateBankCardPreferredMerchantCategoryCode
• Eliminar — deleteBankCard (establece el estado a 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–7 días hábiles. Si no se liquida, se cobra la tarjeta de respaldo.

​

PayPal / Apple Pay / Google Pay

💡 Algunos comercios restringen qué métodos de pago 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 que devuelve getWallet.

​

Lectura de fuentes de fondos vía API

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