Administrar tarjetas bancarias vinculadas

Una tarjeta bancaria —débito, crédito o prepago— 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 utilizan para pagar compras de tarjetas de regalo, financiar transacciones con tarjetas virtuales, depositar en tu saldo de Fluz y servir como respaldo requerido 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 a 7 días hábiles. Si no se liquida, se cobra la tarjeta de respaldo.

Qué puedes hacer

Acción	Mutación	Descripción
Agregar tarjeta bancaria	`addBankCard`	Agrega una tarjeta de débito, crédito o prepago 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`	Elimina una tarjeta estableciendo su estado en `INACTIVE`.

Todas las mutaciones de tarjetas bancarias requieren el scope MANAGE_PAYMENT.

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

Tipo de tarjeta	Comisión de procesamiento	Cashback relativo
Débito	–1%	Mayor
Crédito	–3%	Menor
Prepago	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 comisiones de procesamiento y ganan la tasa completa de cashback del comercio. Cuando un usuario tiene la opción, ACH gana más, débito le sigue, y crédito tiene la comisión más alta. Consulta Cuentas bancarias para la opción sin comisiones.

Requisitosámbito. Cada mutación de tarjeta bancaria requiere el scope `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 acceso público que quieran agregar tarjetas bancarias deberán completar la certificación PCI y una atestación de cumplimiento PCI. Si tu aplicación no está certificada por PCI, dirige a los usuarios a agregar tarjetas bancarias mediante la app o el portal web de Fluz.

Configurar 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 mediante la API.

Lectura de tarjetas bancariase `getWallet` consulta 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 para solicitar una demo.

​Qué puedes hacer

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

​Requisitosámbito. Cada mutación de tarjeta bancaria requiere el scope MANAGE_PAYMENT en el token de acceso del usuario.

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

Qué puedes hacer

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

Requisitosámbito. Cada mutación de tarjeta bancaria requiere el scope `MANAGE_PAYMENT` en el token de acceso del usuario.

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