Descripción general

Una tarjeta bancaria — de débito, crédito o prepaga — es la fuente de fondos más flexible en Fluz y la única que se puede agregar de forma programática. Las tarjetas bancarias se usan para pagar compras de tarjetas de regalo, financiar transacciones con tarjetas virtuales, depositar a tu saldo de Fluz y servir como respaldo obligatorio para otros métodos de pago. Las tarjetas bancarias se pueden agregar y administrar a través de la API o mediante la app y el portal web de Fluz.

Se debe agregar una tarjeta bancaria como método de pago de respaldo antes de que cualquier transacción pueda completarse.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.

Lo que puedes hacer

Acción	Mutación	Descripción
Agregar tarjeta bancaria	`addBankCard`	Agrega una tarjeta de débito, crédito o prepaga a la cuenta de un usuario con una dirección de facturación.
Actualizar tarjeta bancaria	`updateBankCardNickname` · `updateBankCardPreferredMerchantCategoryCode`	Cambia el nombre de una tarjeta o establece su código de categoría de comercio (MCC) preferido.
Eliminar tarjeta bancaria	`deleteBankCard`	Quita una tarjeta estableciendo su estado en `INACTIVE`.

Todas las mutaciones de tarjetas bancarias requieren el alcance MANAGE_PAYMENT.

Tarifas y cashbackEl tipo de tarjeta afecta la tasa efectiva de cashback que un usuario gana en una compra:

Tipo de tarjeta	Tarifa de procesamiento	Cashback relativo
Débito	–1%	Mayor
Crédito	–3%	Menor
Prepaga	Varía según la tarjeta	Varía

Las tarjetas de débito ganan más cashback que las tarjetas de crédito.Las cuentas bancarias (ACH) no tienen tarifas de procesamiento y ganan la tasa completa de cashback del comercio. Cuando un usuario tiene opción, ACH gana más, débito sigue en segundo lugar y crédito conlleva la tarifa más alta. Consulta Cuentas bancarias para la opción sin tarifas.

Requisitosalcance. Cada mutación de tarjeta bancaria requiere el alcance `MANAGE_PAYMENT` en el token de acceso del usuario.

Dirección de facturación. Cada tarjeta debe estar asociada a una dirección. Proporciona un nuevo objeto billingAddress o un userAddressId existente — no ambos. Usa la consulta getUserAddresses para buscar un userAddressId almacenado.

Solo las aplicaciones personales pueden agregar tarjetas bancarias a través de la API.Las aplicaciones de disponibilidad pública que deseen agregar tarjetas bancarias deberán completar la certificación PCI y una atestación de cumplimiento PCI. Si tu aplicación no está certificada en PCI, dirige a los usuarios a agregar tarjetas bancarias mediante la app o el portal web de Fluz.

Establecer una tarjeta Principal, Preferida o de Respaldo, actualizar y eliminar tarjetas está disponible a través de la API. Elegir qué fuente de fondos es principal, preferida o de respaldo se gestiona en el panel de Fluz, no a través de la API.

Lectura de tarjetas bancariase la consulta `getWallet` para devolver todas las tarjetas bancarias en la cuenta de un usuario, junto con su tipo, últimos cuatro dígitos y estado actual.

query getWallet {
  getWallet {
    bankCards {
      bankCardId
      cardType
      lastFourDigits
      cardStatus
    }
  }
}

Consulta Ver fuentes de fondos para la referencia completa de campos.

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

​Lo que puedes hacer

​Tarifas y cashbackEl tipo de tarjeta afecta la tasa efectiva de cashback que un usuario gana en una compra:

​Requisitosalcance. Cada mutación de tarjeta bancaria requiere el alcance MANAGE_PAYMENT en el token de acceso del usuario.

​Lectura de tarjetas bancariase la consulta getWallet para devolver todas las tarjetas bancarias en la cuenta de un usuario, junto con su tipo, últimos cuatro dígitos y estado actual.

Lo que puedes hacer

Tarifas y cashbackEl tipo de tarjeta afecta la tasa efectiva de cashback que un usuario gana en una compra:

Requisitosalcance. Cada mutación de tarjeta bancaria requiere el alcance `MANAGE_PAYMENT` en el token de acceso del usuario.

Lectura de tarjetas bancariase la consulta `getWallet` para devolver todas las tarjetas bancarias en la cuenta de un usuario, junto con su tipo, últimos cuatro dígitos y estado actual.