Suscríbete a las actualizaciones en la Página de estado de Fluz para incidentes y notificaciones proactivas de cambios. También puedes suscribirte a este registro de cambios vía RSS.
- Nuevo endpoint de la API que expone transacciones rechazadas relacionadas con la cuenta. Consulta Obtener transacciones rechazadas.
- Se agregó compatibilidad con Plaid Link.
- Se actualizó la página de Descripción general con información de
llms.txt. - Encabezado actualizado con enlace de IA a
llms.txt.
- Nueva query
getCardProvisioningUrl— genera una URL corta de un solo uso que, al abrirse en un dispositivo móvil, lanza Fluz y agrega una tarjeta virtual a Apple Pay (iOS) o Google Pay (Android). Muéstrala como código QR, SMS, email o botón en la app. Cada URL expira ~5 minutos después de su creación. Requiere el alcanceCREATE_VIRTUALCARD. - Nueva entrada
GetCardProvisioningUrlInput { offerId, platform }. - Nuevo enum
ProvisioningPlatform(IOS|ANDROID|OTHER) — controla únicamente el fallback en escritorio / dispositivo desconocido; las aperturas en iOS y Android se enrutan automáticamente. - Nuevo tipo de retorno
CardProvisioningUrl { url, expiresAt }.
- Se añadieron ejemplos a Generar enlaces para compartir.
- Se agregó la mutación
addVirtualCardAddresspara guardar direcciones de facturación para la emisión de tarjetas virtuales. - Se actualizó la mutación
createVirtualCardpara admitir la creación de tarjetas en nombre de usuarios autorizados. - Se añadió el flujo completo usando
registerUser,addAuthorizedUser,addVirtualCardAddressycreateVirtualCard. - Reintenta aprobaciones pendientes del emisor con
VC-0020yaddressIddevuelto.
redeemFluzGiftCard— Canjear una Fluz Gift Card usando un código. AcreditagiftCardCashBalance. RequiereMAKE_DEPOSIT. Consulta Canjear una Fluz Gift Card.unlockVirtualCard— Desbloquear una tarjeta virtual previamente bloqueada para restaurar la capacidad de transacción. RequiereEDIT_VIRTUALCARD. Consulta Desbloquear una tarjeta virtual.
Webhooks relacionados con transacciones
- Se agregó la descripción para los webhooks
TRANSACTION_CREATE,TRANSACTION_UPDATEyTRANSACTION_DECLINE. - Se incluyeron nuevos campos después del enriquecimiento del webhook (relacionados con MCC,
virtualCardId, etc.).
- Se agregaron
mcc,merchantCountryCode,originalCurrencyCode,originalCurrencyAmountycurrencyConversionRateaVirtualCardTransaction. Ahora los devuelvegetVirtualCardTransactions. - Se hizo opcional
virtualCardIdsengetVirtualCardTransactions— omítelo para consultar transacciones de todas las tarjetas en la cuenta autenticada. Se agregaron filtrosdateRangeStartydateRangeEnd.limitpredeterminado de 100 cuando se omitevirtualCardIds;limitestá limitado a 500.transactionAmountahora puede ser nulo para filas sin un monto liquidado (p. ej., registros de rechazo solo AVS). - Se agregaron
usePrepaymentBalanceyuseRewardsBalanceaCreateVirtualCardInput. Ahora aceptado porcreateVirtualCard. Ambos predeterminados atrue(se conserva el comportamiento existente). Establece ambos enfalsepara restringir una tarjeta a extraer solo de lauserCashBalanceIdespecificada, excluyendo fondos prepagos (tarjeta de regalo) y recompensas.
- Se agregaron
shortDescription(Merchant) ytermsAndConditions(Offer). Ahora devueltos porgetMerchantsygetOfferQuote. - Se agregó
deliveryFormat(GiftCard). Ahora devuelto porgetGiftCards— utilizadeliveryFormatpara tarjetas compradas.
- Nueva mutación
setVirtualCardPIN, que permite a un usuario establecer su NIP en tarjetas virtuales elegibles. Consulta Establecer el NIP de una tarjeta virtual.
- Nuevas consultas
getUserCashBalancesygetUserCashBalanceById. Estas consultas permiten a un usuario recuperar una lista de sus cuentas de gasto y una cuenta de gasto específica creada en su cuenta.
API para compartir tarjetas virtuales
- Nueva capacidad de “Compartir tarjetas virtuales” bajo Administrar tarjetas virtuales. Contacta a ventas para obtener acceso.
- Se agregó el alcance
CREATE_SHARE_LINKa la página de alcances de la aplicación.
API de registro de empresas
- Nueva query
getBusinessCategories: [BusinessCategory]para recuperar categorías de negocio, con tipos de respuestaBusinessCategoryyBusinessSubCategory. - Nueva mutación
registerBusiness(input: RegisterBusinessInput!): RegisterBusinessResultpara el registro programático de empresas. - Nuevos tipos de entrada:
RegisterBusinessInput,BusinessLegalAddressInput,BusinessOwnerInput,OwnerAddressInput. - Nuevos enums:
BusinessStructure(LLC,CORPORATION,PARTNERSHIP,SOLE_PROPRIETORSHIP,COOP) yBusinessAccountUsage. - Nuevos tipos de respuesta:
RegisterBusinessResult { accountId, kybStatus, success, error }yRegisterBusinessError { message, code }. - Ambas operaciones requieren autenticación con el alcance OAuth
REGISTER_BUSINESS.
Actualizaciones a la query
getMerchants- La query
getMerchantsahora devuelve correctamente todas las ofertas disponibles. - La query
getMerchantsahora puede devolver un campoexclusiveRateId(dentro del objetooffers). Este valor puede usarse enpurchaseGiftCardpara especificar la oferta de tarifa exclusiva con la que deseas comprar.
APIs de Retiros y Cuentas de gasto
- Se agregó la mutación
withdrawCashBalancecon el requisito de alcanceMAKE_WITHDRAWAL. - Se agregó el enum
WithdrawMethodscon soporte para los métodosPAYPAL,BANK_ACH,BANK_CARDyVENMO. - Se agregó el enum
WithdrawSourcecon soporte para fuentesCASH_BALANCEyREWARDS_BALANCE. - Se agregó
WithdrawCashBalanceInputcon soporte de idempotencia, además de los tiposWithdrawyWithdrawCashBalanceResponsecon detalles completos del registro de retiro, incluidas comisiones, estado y marcas de tiempo. - Se agregó la mutación
transferUserCashBalancecon el requisito de alcanceMAKE_INTERNAL_TRANSFER, además de los tiposTransferInternalBalanceInputyTransferInternalBalanceResponse. - Se agregó
userCashBalanceIdaEditVirtualCardInputpara habilitar el cambio de la fuente de fondos a una cuenta de gasto especificada medianteeditVirtualCard. - Se agregó
userCashBalanceIdsaTransactionFilterInputpara filtrar transacciones por cuentas de gasto mediantegetTransactions, yuserCashBalanceIdagetGiftCardspara filtrar tarjetas de regalo por cuenta de gasto. - Se agregaron las mutaciones
updateUserCashBalanceycloseUserCashBalancecon el requisito de alcanceMANAGE_PAYMENT, además de los tipos de entrada y respuesta de soporte (UpdateUserCashBalanceInput,CloseUserCashBalanceInput,CloseUserCashBalanceResponse,ClosedUserCashBalance,CloseUserCashBalanceResponseVirtualCard). - Se agregó registro de acciones de la aplicación para la pista de auditoría.
- Se agregó un nuevo campo
userCashBalancesal tipoUserBalancesen la querygetWallet. Devuelve información detallada sobre cuentas individuales de saldo en efectivo del usuario con paginación víapaginate(limit/offset), ordenadas por fecha de creación (más reciente primero). IncluyeuserCashBalanceId,totalCashBalance,availableCashBalance,lifetimeCashBalance,nickname,statusycreatedAt— lo que permite el seguimiento de múltiples cuentas de saldo en efectivo por usuario con apodos personalizados y monitoreo de estado.
- Se agregó un nuevo campo
userCashBalanceIdaDepositCashBalanceInputpara especificar el saldo en efectivo (cuenta de gasto) en el que depositar los fondos.
- Nuevas mutaciones para administrar tarjetas bancarias guardadas:
updateBankCardNickname,updateBankCardPreferredMerchantCategoryCodeydeleteBankCard, con los tipos de entrada correspondientes. - Campo
nicknameagregado al tipoBankCard. - Campos opcionales agregados a
AddBankCardInput:nicknameypreferredMerchantCategoryCode(MCC, normalizado a 4 dígitos).
getVirtualCardBalance: nueva query que recupera información de saldo para una lista de tarjetas virtuales, incluyendospentAmount,remainingBalance,spendLimityspendLimitDuration.getVirtualCardTransactions: nueva query que recupera transacciones para una lista de tarjetas virtuales, con filtros comotransactionTypes.
- La query
getUserPurchasesahora incluye la capacidad de filtrar las compras devueltas en la respuesta mediante una nueva variable opcionalUserPurchaseFilterInput. Filtra compras realizadas por el usuario, la cuenta o ambos.
- La respuesta de la mutación
revealVirtualCardByVirtualCardIdahora incluye un nuevo campoauthorizationSetting. - API de tarjetas virtuales en lote: nueva API para crear y administrar una gran cantidad de tarjetas virtuales de forma asíncrona.
- Mutación
createVirtualCardBulkOrder: envía una orden en lote y recibe unorderIdúnico. - Query
getVirtualCardBulkOrderStatus: sondea para rastrear el estado de la orden y recuperar los detalles de las tarjetas al completarse. - El proceso de creación de tarjetas en lote es asíncrono — verifica el estado de la orden para recuperar los detalles de las tarjetas.
- Nueva query
getVirtualCardOffers: lista integral de todas las ofertas activas de tarjetas virtuales disponibles para creación, incluyendoofferId(esencial para la creación de la tarjeta),programName,bankName,rewardValuey límites detallados del programa (límites de gasto diarios, semanales y mensuales). - Mutación actualizada
createVirtualCard: emite tarjetas virtuales por medio de programación proporcionando unofferId(degetVirtualCardOffers), unspendLimity atributos personalizables comocardNicknameyspendLimitDuration. - Nueva mutación
editVirtualCard: actualiza parámetros clave de una tarjeta virtual existente —spendLimit,spendLimitDuration,lockDate,lockCardNextUseycardNickname. - Nueva mutación
lockVirtualCard: bloquea inmediatamente una tarjeta virtual, evitando cualquier transacción posterior.
- El tipo
Offeren la respuesta degetMerchantsahora incluye un campodeliveryFormatque especifica cómo se cumple la oferta:URL,CODES,PIN_AS_CODEoPIN_WITH_URL. - La query
getMerchantsse ha mejorado con un nuevo argumentofilterBy, que te permite filtrar los resultados para incluir solo comercios con ofertas que coincidan con undeliveryFormatespecífico.
- Se mejoró la query
getMerchantscon un nuevo argumento de entradaofferTypes, que permite filtrar porgiftCardOffers,cardLinkedOffers o ambos. De forma predeterminada, si no se proporcionaofferTypes, la query devuelve solo ofertas de tarjetas de regalo.
- Se introdujo una nueva query
getReferralUrlque devuelve una cadena de referidos según la entrada de comercio, con un nuevo tipoMerchantInput. - Se introdujo un intento de recompra automática en la mutación
purchaseGiftCard. Si una compra de tarjeta de regalo usando tarjeta bancaria, cuenta bancaria o PayPal falla, el sistema intenta automáticamente recomprar usando el saldo de Fluz. - Se introdujo el campo
defaultToBalanceenPurchaseGiftCardInputpara configurar el saldo de Fluz como método de pago de respaldo si falla el método de pago principal. Predeterminado atrue.
- Se introdujo un nuevo alcance de acceso,
CREATE_VIRTUALCARD, para crear tarjetas virtuales. - Se introdujo una nueva función,
createVirtualCard, para crear tarjetas virtuales con parámetros específicos. - Se agregó una nueva query,
getBINs, para recuperar los BIN asociados con tarjetas virtuales. - Se introdujo una entrada
merchantCategoryCodepara depósitos al saldo en efectivo, lo que permite una mejor categorización de transacciones. - Se agregó una nueva query,
getMccList, para recuperar una lista de códigos de categoría de comercio. - Se mejoró la validación de alcances para la query
getApplicationScopesy se mejoró la gestión de definiciones de tipos de GraphQL.
- Se mejoró el manejo de la información de stock para ofertas de comercios: el campo
stockInfodel objetoOfferahora devuelveStockInfoFixedTypeoStockInfoVariableTypesegún si la oferta es fija o variable. - Se mejoró el manejo de errores con respuestas de mensajes de error más intuitivas — respuestas mejoradas para errores de
purchaseGiftCardsin oferta y métodos de pago que no coinciden con la cuenta.
v0.0.21
- Se introdujo un parámetro
idempotencyKeyparadepositCashBalanceypurchaseGiftCardspara evitar solicitudes duplicadas. - Se agregaron los tipos
purchaseGiftCardInputpara agilizar el manejo de parámetros para transacciones. - Se introdujo un nuevo campo
purchaseDisplayIden el tipoUserPurchase, que proporciona un ID de visualización para las compras. - Se corrigió el campo
offeringMerchantIddel objetoOfferpara devolveroffering_merchant_iden lugar deoffer_id.
- Se agregó el requisito
accountIdagenerateUserAccessToken. - Se implementó una nueva query,
getAccountsByUserId, para obtener cuentas segúnuserId. - Se agregó un nuevo enum
AccountTypepara categorizar cuentas comoCONSUMERoBUSINESS, además de nuevos objetosAccount,BusinessySeat.
- Se corrigió la entrada del canal de plataforma de
depositCashBalancepara que la fuente del registro de la transacción de depósito se registre comoAPI.