Antecedentes

Una fuente de fondos, también conocida como método de pago, se utiliza en Fluz para comprar tarjetas de regalo, financiar transacciones con tarjeta virtual, depositar fondos en tu saldo de Fluz y más. Lo primero que querrás hacer es asegurarte de tener al menos una fuente de fondos para completar transacciones en Fluz. Una cuenta de usuario puede tener los siguientes tipos:

Tarjeta bancaria: Una tarjeta de débito, crédito o prepaga. Ten en cuenta que las tarjetas de crédito pueden tener comisiones más altas y menores tasas de cashback que las tarjetas de débito.
Cuenta bancaria: Las cuentas bancarias no tienen comisiones. Sin embargo, solo se pueden agregar en la app de Fluz o el portal web.
Cuenta de PayPal: Las billeteras digitales como PayPal suelen tener las comisiones más altas y deben agregarse desde la app de Fluz o el portal web.

Debes agregar una tarjeta bancaria como método de pago de respaldo para poder realizar una compra.

Actualmente, los usuarios solo pueden agregar tarjetas bancarias como fuente de fondos a través del API.

Agregar tarjeta bancaria

Solicitud de ejemplo

Puedes agregar una nueva tarjeta bancaria con la mutación addBankCard. Esta mutación te permite proporcionar los detalles necesarios para agregar una tarjeta bancaria a la cuenta de un usuario. La consulta recibe un objeto de entrada AddBankCardInput.

{
  "query": "mutation addBankCard($input: AddBankCardInput!) { addBankCard(input: $input) { bankCardId ownerAccountId addedUserId cardType cardProcessor cardholderName lastFourDigits expirationMonth expirationYear cardStatus billingAddressId nickname }}",
  "variables": {
    "input": {
      "cardNumber": "4111111111111111",
      "expirationMonth": "01",
      "expirationYear": "2029",
      "cvv": "111",
      "cardholderName": "John Doe",
      "nickname": "My travel card",
      "preferredMerchantCategoryCode": "5411",
      "billingAddress": {
        "streetAddressLine1": "123 Example St",
        "streetAddressLine2": "Unit 1",
        "country": "United States",
        "city": "New York City",
        "state": "New York",
        "postalCode": "12345"
      }
    }
  }
}

Esta mutación requiere el tipo de entrada AddBankCardInput. Cualquier campo marcado con un signo de exclamación (!) en el esquema es obligatorio y debe incluirse en la solicitud. Para asociar una dirección con tu tarjeta bancaria, debes usar el campo de entrada billingAddress o userAddressId. Asegúrate de proporcionar solo uno de estos campos para cumplir con los requisitos de validación.

Dirección nueva: Para agregar una nueva dirección, usa el campo de entrada billingAddress para definir los detalles de la dirección asociada con esta tarjeta.
Dirección existente: Para vincular una dirección existente, usa el campo de entrada userAddressId, especificando el identificador de la dirección ya almacenada en el sistema. Puedes usar la consulta getUserAddresses para buscar un userAddressId existente.

Formato de la dirección de facturaciónProporciona la dirección de facturación exactamente como aparece en los registros del emisor de la tarjeta, usando los campos estructurados (streetAddressLine1, streetAddressLine2, city, state, postalCode, country). Una dirección de facturación que no coincida o esté mal formada puede hacer que la tarjeta falle la verificación de dirección (AVS). Se aceptan direcciones de facturación internacionales para tarjetas bancarias. Consulta Requisitos de formato de dirección para reglas de formato y ejemplos.

Nombre del campo	Tipo	Descripción
cardNumber	String!	El número de la tarjeta. Este campo requiere el número completo de la tarjeta, por lo general 16 dígitos.
expirationMonth	String!	El mes de expiración de la tarjeta, con formato MM (por ejemplo, “07” para julio).
expirationYear	String!	El código de seguridad de tres o cuatro dígitos, ubicado en la parte posterior o frontal de la tarjeta.
cvv	String!	El código de seguridad de tres o cuatro dígitos, ubicado en la parte posterior o frontal de la tarjeta.
cardholderName	String!	El nombre del titular tal como aparece en la tarjeta.
billingAddress	UserAddressInput	Opcional. Usa este campo para crear la tarjeta con una nueva dirección de facturación.
userAddressId	UUID	Opcional. Usa este campo para asociar la tarjeta con una dirección de usuario existente.
nickname	String	Opcional. Usa este campo para crear una tarjeta con un apodo.
preferredMerchantCategoryCode	String	Opcional. Usa este campo para asociar la tarjeta con un código de categoría de comercio.

AddBankCardInput

{
  "cardNumber": "xyz789",
  "expirationMonth": "xyz789",
  "expirationYear": "abc123",
  "cvv": "abc123",
  "cardholderName": "abc123",
  "billingAddress": UserAddressInput,
  "userAddressId": "0284be6f-1a69-44f7-9da0-5b5edaf45d19",
  "nickname": "My travel card",
  "preferredMerchantCategoryCode": "5411"
}

Respuesta de ejemplo

La respuesta de la mutación addBankCard incluirá los campos que especificaste en la solicitud de mutación, junto con los valores de ID relevantes y el procesador de la tarjeta.

{
  "data": {
    "addBankCard": {
      "bankCardId": "4111111111111111",
      "ownerAccountId": "a578fe07-7165-47b8-b147-2251c99b7fc1",
      "addedUserId": "8d197a56-53df-439b-85cd-bb88dfca9a5f",
      "cardType": "Visa",
      "cardProcessor": "Stripe",
      "cardholderName": "John Doe",
      "lastFourDigits": "1234",
      "expirationMonth": "12",
      "expirationYear": "2025",
      "cardStatus": "active",
      "billingAddressId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
      "nickname": "My travel card"
    }
  }
}

Disponible solo para aplicaciones personalesActualmente, solo a las aplicaciones personales se les otorgará el alcance para agregar tarjetas bancarias a una cuenta. Las aplicaciones de disponibilidad pública que deseen agregar tarjetas bancarias a una cuenta deberán completar la certificación PCI y una atestación de cumplimiento PCI.

Si deseas configurar una determinada fuente de fondos como principal, preferida o de respaldo en tu cuenta, esto deberá administrarse en el panel de Fluz. ¿Quieres saber más? Contáctanos en tu correo de soporte. Habla con nuestros expertos para más información o para solicitar una demostración.

​Antecedentes

​Agregar tarjeta bancaria

​Solicitud de ejemplo

​AddBankCardInput

​Respuesta de ejemplo

Antecedentes

Agregar tarjeta bancaria

Solicitud de ejemplo

AddBankCardInput

Respuesta de ejemplo