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.
- Señal de billetera digital en transacciones. Los eventos de webhook
TRANSACTION_CREATEyTRANSACTION_UPDATEy el APIgetTransactionsahora incluyendigitalWalletProvider(APPLE_PAY,GOOGLE_PAYo ausente) para que puedas saber cuándo una transacción con tarjeta se realizó a través de una billetera móvil, además dedigitalWalletToken(el id del token de la red). UsadigitalWalletProvidercomo la señal de billetera —digitalWalletTokentambién se establece para tokens de red que no son de billetera, por lo que su sola presencia no significa que se usó una billetera. Aditivo y compatible hacia atrás. Consulta Webhooks.
- Tarjetas Open Loop: ya no se solicita a los destinatarios crear un PIN durante el flujo inicial de activación, y la tarjeta ya no se revela automáticamente al reclamarla. Revelar una tarjeta ahora solicita al destinatario ingresar su PIN o crear uno si aún no lo ha configurado. Consulta Experiencia del destinatario.
- Actualiza GenerateVCShareLinksInput para Tarjetas Open Loop. Consulta Tarjetas Open Loop.
- Actualizaciones en la página de fondos primarios y de respaldo.
- Nuevo endpoint de API que expone transacciones rechazadas relacionadas con la cuenta. Consulta Obtener transacciones rechazadas.
GiftCard.purchaseId(UUID) — la compra que creó la tarjeta de regalo; el mismo ID que devuelvepurchaseGiftCardygetUserPurchases. Devuelvenullsi no hay compra asociada.GiftCard.purchaseDisplayId(String) — el ID corto y legible de la transacción de Fluz (p. ej.,1047283) que soporte referencia en revisiones manuales y exportaciones. Devuelvenullsi no hay compra asociada.GiftCard.purchaseValue(Float) — el valor nominal (denominación) al que se compró la tarjeta de regalo, en la moneda de la tarjeta.GiftCard.currentValue(Float) — el saldo restante en la tarjeta de regalo; igual apurchaseValuepara tarjetas de un solo uso.GiftCard.currency(String) — el código de moneda ISO del valor de la tarjeta de regalo (p. ej.,USD).
getGiftCards (y en cualquier lugar donde se exponga GiftCard), lo que habilita la conciliación de pedidos/valores sin llamar a revealGiftCardByGiftCardId por tarjeta. Aditivo y compatible hacia atrás.- Se agregó compatibilidad con Plaid Link.
- Página de Descripción general actualizada con información de
llms.txt. - Encabezado actualizado con enlace de IA a
llms.txt.
- Nueva query
getCardProvisioningUrl— genera una URL corta y 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 un código QR, SMS, correo electrónico o botón en la app. Cada URL expira ~5 minutos después de su creación. Requiere el scopeCREATE_VIRTUALCARD. - Nuevo input
GetCardProvisioningUrlInput { offerId, platform }. - Nuevo enum
ProvisioningPlatform(IOS|ANDROID|OTHER) — controla únicamente el fallback para escritorio/dispositivo desconocido; las aperturas en iOS y Android se enrutan automáticamente. - Nuevo tipo de retorno
CardProvisioningUrl { url, expiresAt }.
- Se agregaron 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. - Flujo completo agregado 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— Desbloquea una tarjeta virtual previamente bloqueada para restaurar la capacidad de realizar transacciones. RequiereEDIT_VIRTUALCARD. Consulta Desbloquear una tarjeta virtual.
Webhooks relacionados con transacciones
- Se agregó 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. virtualCardIdsahora es opcional engetVirtualCardTransactions— omítelo para consultar transacciones en todas las tarjetas de la cuenta autenticada. Se agregaron filtrosdateRangeStartydateRangeEnd.limitpredeterminado de 100 cuando se omitevirtualCardIds;limittiene un tope de 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 entrue(se conserva el comportamiento existente). Configura ambos enfalsepara restringir que una tarjeta extraiga solo de lauserCashBalanceIdespecificada, excluyendo fondos prepagos (tarjeta de regalo) y recompensas.
- Se agregaron
shortDescription(Merchant) ytermsAndConditions(Offer). Ahora los devuelvegetMerchantsygetOfferQuote. - Se agregó
deliveryFormat(GiftCard). Ahora lo devuelvegetGiftCards— usadeliveryFormatpara tarjetas compradas.
- Nueva mutación
setVirtualCardPIN, que permite a un usuario establecer su PIN en tarjetas virtuales elegibles. Consulta Configurar el PIN de una tarjeta virtual.
- Nuevas queries
getUserCashBalancesygetUserCashBalanceById. Estas queries 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” en Administrar tarjetas virtuales. Contacta a ventas para obtener acceso.
- Se agregó el scope
CREATE_SHARE_LINKa la página de scopes de la aplicación.
API de registro de empresas
- Nueva query
getBusinessCategories: [BusinessCategory]para recuperar categorías de empresas, con tipos de respuestaBusinessCategoryyBusinessSubCategory. - Nueva mutación
registerBusiness(input: RegisterBusinessInput!): RegisterBusinessResultpara el registro programático de empresas. - Nuevos tipos de input:
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 scope 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 se puede usar enpurchaseGiftCardpara especificar la oferta de tasa exclusiva con la que deseas comprar.
APIs de Retiros y Cuentas de gasto
- Se agregó la mutación
withdrawCashBalancecon el requisito del scopeMAKE_WITHDRAWAL. - Se agregó el enum
WithdrawMethodscon soporte para los métodosPAYPAL,BANK_ACH,BANK_CARDyVENMO. - Se agregó el enum
WithdrawSourcecon soporte para las 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 del scopeMAKE_INTERNAL_TRANSFER, además de los tiposTransferInternalBalanceInputyTransferInternalBalanceResponse. - Se agregó
userCashBalanceIdaEditVirtualCardInputpara permitir cambiar 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 del scopeMANAGE_PAYMENT, además de los tipos de input y respuesta de soporte (UpdateUserCashBalanceInput,CloseUserCashBalanceInput,CloseUserCashBalanceResponse,ClosedUserCashBalance,CloseUserCashBalanceResponseVirtualCard). - Se agregó el 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(límite/desplazamiento), ordenado por fecha de creación (más reciente primero). IncluyeuserCashBalanceId,totalCashBalance,availableCashBalance,lifetimeCashBalance,nickname,statusycreatedAt, lo que habilita 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 se depositarán los fondos.
- Nuevas mutaciones para administrar tarjetas bancarias guardadas:
updateBankCardNickname,updateBankCardPreferredMerchantCategoryCodeydeleteBankCard, con los tipos de input 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: consulta para rastrear el estado de la orden y recuperar los detalles de las tarjetas al completar. - El proceso de creación de tarjetas en lote es asíncrono — consulta el estado de la orden para recuperar los detalles de las tarjetas.
- Nueva query
getVirtualCardOffers: lista completa de todas las ofertas activas de tarjetas virtuales disponibles para creación, incluyendoofferId(esencial para la creación de tarjetas),programName,bankName,rewardValuey límites detallados del programa (límites de gasto diarios, semanales y mensuales). - Mutación actualizada
createVirtualCard: emite tarjetas virtuales de forma programática 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, impidiendo 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 permite filtrar resultados para incluir solo comercios con ofertas que coinciden 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 referido basada en la entrada del comercio, con un nuevo tipoMerchantInput. - Se introdujo un intento automático de recompra en la mutación
purchaseGiftCard. Si una compra de tarjeta de regalo usando una tarjeta bancaria, cuenta bancaria o PayPal falla, el sistema intenta automáticamente recomprar usando el saldo de Fluz. - Se introdujo el campo
defaultToBalanceenPurchaseGiftCardInputpara establecer el saldo de Fluz como método de pago de respaldo si falla el método de pago principal. Predeterminado entrue.
- Se introdujo un nuevo scope 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 un input
merchantCategoryCodepara depósitos en 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. - Validación de scopes mejorada para la query
getApplicationScopesy mejor 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 no-oferta en
purchaseGiftCardy métodos de pago con cuenta no coincidente.
v0.0.21
- Se introdujo un parámetro
idempotencyKeyparadepositCashBalanceypurchaseGiftCardspara evitar solicitudes duplicadas. - Se agregaron 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 compras. - Se corrigió el campo
offeringMerchantIddel objetoOfferpara que devuelvaoffering_merchant_iden lugar deoffer_id.
- Se agregó el requisito
accountIdagenerateUserAccessToken. - Se implementó una nueva query,
getAccountsByUserId, para obtener cuentas basadas enuserId. - Se agregó un nuevo enum
AccountTypepara categorizar cuentas comoCONSUMERoBUSINESS, además de nuevos objetosAccount,BusinessySeat.
- Se corrigió el input de canal de plataforma de
depositCashBalancepara que la fuente del registro de transacciones de depósito se registre comoAPI.