Ver fuentes de fondos

Una vez que hayas agregado fuentes de fondos a tu cuenta de Fluz, puedes recuperar una lista de ellas con la getWalletquery. Esta query proporcionará detalles de todas las fuentes de fondos vinculadas a la billetera del usuario.

Ejemplo de solicitud

query getWallet {
    getWallet {
        bankCards {
            bankCardId
            cardType
            cardholderName
            lastFourDigits
            expirationMonth
            expirationYear
            cardStatus
            billingAddressId
        }
        bankAccounts {
            bankAccountId
            type
            accountName
            status
            achRouting
            lastFour
            nickname
        }
        paypalAccounts {
            paypalVaultId
            status
            email
        }
        blockedPaymentTypes
        balances {
            rewardsBalance {
                availableBalance
                totalBalance
                lifetimeBalance
            }
            cashBalance {
                availableBalance
                totalBalance
                pendingBalance
                lifetimeBalance
            }
            giftCardCashBalance {
                availableBalance
                totalBalance
                pendingBalance
                lifetimeBalance
            }
        }
    }
}

La respuesta de la query incluirá los saldos del usuario y tipos de fuentes de fondos como BankCard, BankAccount y PayPal. Aquí hay un ejemplo del objeto de respuesta:

Ejemplo de respuesta

{
  "data": {
    "getWallet": {
      "bankCards": [
        {
          "bankCardId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "ownerAccountId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "addedUserId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "cardType": "DEBIT",
          "cardProcessor": "xyz789",
          "cardholderName": "John Doe",
          "lastFourDigits": "1234",
          "expirationMonth": "12",
          "expirationYear": "25",
          "cardStatus": "ACTIVE",
          "billingAddressId": "e7979eb7-1727-48ed-8c5a-c56532908c1e"
        }
      ],
      "bankAccounts": [
        {
          "bankAccountId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "accountId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "type": "SAVING",
          "accountName": "John Doe",
          "status": "ENABLED",
          "achRouting": "021000021",
          "lastFour": "1234",
          "authChargeBackupPaymentMethod": true,
          "billingAddressId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "nickname": "Johnny"
        }
      ],
      "paypalAccounts": [
        {
          "paypalVaultId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "userId": "e7979eb7-1727-48ed-8c5a-c56532908c1e",
          "status": "ACTIVE",
          "email": "abc123@example.com"
        }
      ],
      "blockedPaymentTypes": ["BANK_CARD"],
      "balances": {
        "rewardsBalance": "100.00",
        "cashBalance": "250.00",
        "giftCardCashBalance": "50.00"
      }
    }
  }
}

Campos de respuesta explicados

bankCards - BankCardType:

El objeto BankCard representa una tarjeta bancaria que un usuario ha agregado a su cuenta. Cada objeto dentro de este arreglo representa una sola tarjeta bancaria, incluyendo detalles como el número de la tarjeta (enmascarado), fecha de vencimiento, nombre del titular y la información de facturación.

Field name	Type	Description
bankCardId	UUID!	El identificador único de la tarjeta bancaria.
ownerAccountId	UUID!	El identificador único de la cuenta que es dueña de esta tarjeta bancaria.
addedUserId	UUID!	El identificador único del usuario que agregó la tarjeta bancaria a la cuenta.
cardType	BankCardType	El tipo de tarjeta, como DEBIT o CREDIT.
cardProcessor	String	El nombre o código del procesador de la tarjeta.
cardholderName	String	El nombre del titular tal como aparece en la tarjeta bancaria.
lastFourDigits	String	Los últimos cuatro dígitos del número de la tarjeta bancaria, usados para identificación.
expirationMonth	String	El mes en que vence la tarjeta, con formato MM.
expirationYear	String	El año en que vence la tarjeta, con formato YYYY.
cardStatus	BankCardStatus	El estado actual de la tarjeta bancaria, como ACTIVE, INACTIVE o BLOCKED.
billingAddressId	UUID	El identificador único de la dirección de facturación asociada a esta tarjeta bancaria.

bankAccounts - [BankAccount]:

El objeto BankAccount es un registro de una cuenta bancaria que un usuario ha agregado a su cuenta. Almacena información clave sobre la cuenta bancaria, incluyendo el tipo de cuenta, estado, detalles y la dirección de facturación asociada.

Field name	Type	Description
bankAcountid	UUID!	El identificador único de la cuenta bancaria.
accountId	UUID!	El identificador único de la cuenta asociada con esta cuenta bancaria.
type	BankAccountType!	El tipo de cuenta bancaria, como CHECKING o SAVING.
accountName	String!	El nombre asociado con la cuenta bancaria.
status	String!	El estado actual de la cuenta bancaria, como ENABLED, DISABLED.
achRouting	String!	El número de ruta ACH (Automated Clearing House) para la cuenta bancaria.
lastFour	String!	Los últimos cuatro dígitos del número de la cuenta bancaria, usados para identificación.
authChargeBackupPaymentMethod	Boolean!	Indica si esta cuenta bancaria está configurada como método de pago de respaldo para cargos.
billingAddressId	UUID!	El identificador único de la dirección de facturación asociada a esta cuenta bancaria.
nickname	String	Un apodo opcional asignado a la cuenta bancaria para facilitar su identificación.

paypalAccounts - [Paypal]:

El objeto Paypal representa una cuenta de PayPal que un usuario ha agregado a su cuenta. Este objeto contiene detalles esenciales sobre la cuenta de PayPal, incluido su identificador único, el usuario asociado, el estado y la dirección de correo electrónico.

Field name	Type	Description
paypalVaultId	UUID!	El identificador único de la cuenta de PayPal.
userId	UUID!	El identificador único del usuario que agregó la cuenta de PayPal.
status	PayPalAccountStatus!	El estado actual de la cuenta de PayPal, como ACTIVE, INACTIVE, etc.
email	String!	La dirección de correo electrónico asociada con la cuenta de PayPal.

blockedPaymentTypes - [PaymentMethodType]:

Descripción: Este arreglo enumera los tipos de pago que están actualmente bloqueados para el usuario.
Detalles: Si un tipo de pago está bloqueado, significa que el usuario no puede usar este método para transacciones en la plataforma. Por ejemplo, “BANK_CARD” indica que el uso de tarjetas bancarias está actualmente restringido. Valores del enum PaymentMethodType:

"BANK_CARD": Indica que las tarjetas bancarias están bloqueadas.
"BANK_ACCOUNT": Indica que las cuentas bancarias están bloqueadas.
"PAYPAL": Indica que PayPal está bloqueado.
"FLUZPAY": Indica que tu saldo de Fluz está bloqueado.
"APPLE_PAY": Indica que tu billetera de Apple Pay está bloqueada.
"GOOGLE_PAY": Indica que tu billetera de Google Pay está bloqueada.

balances - UserBalances:

Descripción: Este objeto contiene los saldos actuales del usuario, incluyendo Cash Balance, Rewards Balance y el saldo de prepago de Fluz. Para aprender más, puedes ver ‘Revisar saldos de la cuenta’.

​Ejemplo de solicitud

​Ejemplo de respuesta

​Campos de respuesta explicados

​bankCards - BankCardType:

​bankAccounts - [BankAccount]:

​paypalAccounts - [Paypal]:

​blockedPaymentTypes - [PaymentMethodType]:

​balances - UserBalances: