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 documentó cómo se usan las tarjetas de débito para el movimiento de dinero. Los depósitos desde una tarjeta de débito a
CASH_BALANCEpueden procesarse como transacciones de fondeo de cuenta (AFT), que tienen su propia tasa de comisión — leedepositFeede la respuesta en lugar de calcularla. Los retiros push-to-card (method: BANK_CARD) se entregan como transacciones de crédito original (OCT). La elegibilidad de la tarjeta para cualquiera de los dos no está disponible por adelantado y es independiente por dirección — una tarjeta desde la que un usuario puede depositar no es necesariamente una tarjeta a la que puedas enviar un retiro. Consulta Depositar desde cuentas externas y Retirar a cuenta externa. isExpeditedenWithdrawCashBalanceInputahora controla la velocidad de entrega push-to-card:trueentrega a la tarjeta de inmediato,falseu omitido liquida en el cronograma estándar. Un retiro push-to-card estándar aún puede fallar después de ser enviado y reembolsarse al balance de origen — por lo tanto, un retiroPENDINGaún no es definitivo.- Se documentó
getWithdrawFeeEstimateen Retirar a cuenta externa para previsualizarfee,netAmount,feePercent,feeMaxCapysettlementDelayDaysantes de enviar un retiro. - Correcciones en Retirar a cuenta externa: el alcance requerido es
MAKE_WITHDRAWAL(noMANAGE_PAYMENT), los códigos de error son los realesWDR-*/ARG-*/HN-*/BC-*/G-*, yFLUZPAY— aunque está presente en el enumWithdrawMethods— no es un método de retiro utilizable:withdrawCashBalancelo rechaza conWDR-0004ygetWithdrawFeeEstimateconARG-0001.
- Señal de billetera digital en transacciones. Los eventos webhook
TRANSACTION_CREATEyTRANSACTION_UPDATEy el APIgetTransactionsahora incluyendigitalWalletProvider(APPLE_PAY,GOOGLE_PAY, o ausente) para que puedas saber cuándo una transacción de 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 presencia por sí sola no significa que se usó una billetera. Aditivo y compatible hacia atrás. Consulta Webhooks.
- Tarjetas de bucle abierto: los destinatarios ya no reciben la solicitud de crear un PIN durante el flujo de activación inicial, 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 de Bucle Abierto. Consulta Tarjetas de Bucle Abierto.
- Actualizaciones en Página de fondeo principal 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 devuelto porpurchaseGiftCardygetUserPurchases. Devuelvenullsi no hay una compra asociada.GiftCard.purchaseDisplayId(String) — el ID de transacción corto y legible de Fluz (p. ej.,1047283) que soporte referencia en revisiones manuales y exportaciones. Devuelvenullsi no hay una 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; es 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 permite conciliación de pedidos/valores sin llamar a revealGiftCardByGiftCardId por tarjeta. Aditivo y compatible hacia atrás.- Se agregó soporte para Plaid Link.
- Página de visió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 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). Preséntala 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. - Nueva entrada
GetCardProvisioningUrlInput { offerId, platform }. - Nuevo enum
ProvisioningPlatform(IOS|ANDROID|OTHER) — controla solo la experiencia de fallback en escritorio / dispositivo desconocido; las aperturas iOS y Android se enrutan automáticamente. - Nuevo tipo de retorno
CardProvisioningUrl { url, expiresAt }.
- Se agregaron muestras 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 transacción. 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 a MCC,
virtualCardId, etc.).
- Se agregaron
mcc,merchantCountryCode,originalCurrencyCode,originalCurrencyAmountycurrencyConversionRateaVirtualCardTransaction. Ahora devuelto porgetVirtualCardTransactions. virtualCardIdsahora es opcional engetVirtualCardTransactions— omítelo para consultar transacciones en todas las tarjetas de la cuenta autenticada. Se agregaron los filtrosdateRangeStartydateRangeEnd.limitpredeterminado de 100 cuandovirtualCardIdsse omite;limitse limita a 500.transactionAmountahora puede ser nulo para filas sin monto liquidado (p. ej., registros de declinación solo AVS).- Se agregaron
usePrepaymentBalanceyuseRewardsBalanceaCreateVirtualCardInput. Ahora aceptado porcreateVirtualCard. Ambos predeterminan atrue(comportamiento existente preservado). Configura ambos enfalsepara restringir que una tarjeta tome fondos solo de lauserCashBalanceIdespecificada, excluyendo fondos prepagados (tarjeta de regalo) y de recompensas.
- Se agregaron
shortDescription(Merchant) ytermsAndConditions(Offer). Ahora devueltos porgetMerchantsygetOfferQuote. - Se agregó
deliveryFormat(GiftCard). Ahora devuelto porgetGiftCards— usadeliveryFormatpara tarjetas compradas.
- Nueva mutación
setVirtualCardPIN, que permite a un usuario configurar 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” bajo Administrar Tarjetas Virtuales. Contacta a ventas para acceder.
- Se agregó el scope
CREATE_SHARE_LINKa la página de scopes de la aplicación.
API de registro de negocios
- Nueva query
getBusinessCategories: [BusinessCategory]para recuperar categorías de negocio, con tipos de respuestaBusinessCategoryyBusinessSubCategory. - Nueva mutación
registerBusiness(input: RegisterBusinessInput!): RegisterBusinessResultpara registro programático de negocios. - 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 scope OAuth
REGISTER_BUSINESS.
Actualizaciones a la query
getMerchants- La query
getMerchantsahora devuelve todas las ofertas disponibles correctamente. - La query
getMerchantsahora puede devolver un campoexclusiveRateId(dentro del objetooffers). Este valor puede usarse 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 requisito de 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, incluyendo comisiones, estado y marcas de tiempo. - Se agregó la mutación
transferUserCashBalancecon requisito de scopeMAKE_INTERNAL_TRANSFER, además de los tiposTransferInternalBalanceInputyTransferInternalBalanceResponse. - Se agregó
userCashBalanceIdaEditVirtualCardInputpara habilitar cambiar la fuente de fondos a una cuenta de gasto especificada víaeditVirtualCard. - Se agregó
userCashBalanceIdsaTransactionFilterInputpara filtrar transacciones por cuentas de gasto víagetTransactions, yuserCashBalanceIdagetGiftCardspara filtrar tarjetas de regalo por cuenta de gasto. - Se agregaron las mutaciones
updateUserCashBalanceycloseUserCashBalancecon requisito de scopeMANAGE_PAYMENT, además de los tipos de entrada y respuesta de soporte (UpdateUserCashBalanceInput,CloseUserCashBalanceInput,CloseUserCashBalanceResponse,ClosedUserCashBalance,CloseUserCashBalanceResponseVirtualCard). - Se agregó el registro de acciones de la aplicación para traza 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— habilitando 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 a través de una nueva variable opcionalUserPurchaseFilterInput. Filtra compras hechas por el usuario, la cuenta, o ambas.
- 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: haz polling 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 obtener 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 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, 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 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 referido basada en la entrada del comercio, con un nuevo tipoMerchantInput. - Se introdujo un reintento 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 el método de pago principal falla. Predetermina atrue.
- 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 BINs asociados con tarjetas virtuales. - Se introdujo una entrada
merchantCategoryCodepara depósitos al saldo en efectivo, lo que permite una categorización mejorada 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 scopes para la query
getApplicationScopesy se mejoró la gestión de definiciones de tipos GraphQL.
- Mejora en el manejo de información de inventario para ofertas de comercios: el campo
stockInfodel objetoOfferahora devuelveStockInfoFixedTypeoStockInfoVariableTypedependiendo de si la oferta es fija o variable. - Mejora en 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 y cuentas no coincidentes.
v0.0.21
- Se introdujo un parámetro
idempotencyKeyparadepositCashBalanceypurchaseGiftCardspara prevenir solicitudes duplicadas. - Se agregaron tipos
purchaseGiftCardInputpara agilizar el manejo de parámetros para transacciones. - Se introdujo un nuevo campo
purchaseDisplayIden el tipoUserPurchase, proporcionando un ID visible 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 basadas enuserId. - Se agregó un nuevo enum
AccountTypepara categorizar cuentas comoCONSUMERoBUSINESS, además de nuevos objetosAccount,BusinessySeat.
- Se corrigió la entrada de canal de plataforma de
depositCashBalancepara que la fuente del registro de transacción del depósito se registre comoAPI.