- 新增 Plaid Link 支持。
- 在概览页面添加
llms.txt信息。 - 更新页眉，加入指向
llms.txt的 AI 链接。
- 新增
getCardProvisioningUrl查询 —— 生成一个短期的一次性 URL，在移动设备上打开时会启动 Fluz 并将虚拟卡添加到 Apple Pay（iOS）或 Google Pay（Android）。可通过二维码、短信、电子邮件或应用内按钮呈现。每个 URL 在创建约 5 分钟后过期。需要CREATE_VIRTUALCARDscope。 - 新增输入
GetCardProvisioningUrlInput { offerId, platform }。 - 新增枚举
ProvisioningPlatform（IOS|ANDROID|OTHER）—— 仅控制桌面/未知设备的回退行为；iOS 和 Android 的打开会自动路由。 - 新增返回类型
CardProvisioningUrl { url, expiresAt }。
- 新增
addVirtualCardAddress变更，用于保存开卡所需的账单地址。 - 更新
createVirtualCard变更，支持代表授权用户创建卡。 - 新增完整流程：使用
registerUser、addAuthorizedUser、addVirtualCardAddress和createVirtualCard。 - 对带有
VC-0020且返回了addressId的发行方待审批进行重试。
redeemFluzGiftCard—— 使用代码兑换 Fluz 礼品卡。入账至giftCardCashBalance。需要MAKE_DEPOSIT。参见 兑换 Fluz 礼品卡。unlockVirtualCard—— 解锁先前被锁定的虚拟卡以恢复交易能力。需要EDIT_VIRTUALCARD。参见 解锁虚拟卡。
与交易相关的 Webhook
- 为
TRANSACTION_CREATE、TRANSACTION_UPDATE和TRANSACTION_DECLINEwebhooks 添加描述。 - 在 webhook 富化后纳入新字段（与 MCC 相关、
virtualCardId等）。
- 在
VirtualCardTransaction中新增mcc、merchantCountryCode、originalCurrencyCode、originalCurrencyAmount和currencyConversionRate。现在由getVirtualCardTransactions返回。 - 将
getVirtualCardTransactions的virtualCardIds设为可选 —— 省略以在已认证账户的所有卡上查询交易。新增dateRangeStart和dateRangeEnd过滤器。当省略virtualCardIds时默认limit为 100；limit上限为 500。对于无结算金额的行（例如仅 AVS 的拒付记录），transactionAmount现在可为空。 - 在
CreateVirtualCardInput中新增usePrepaymentBalance和useRewardsBalance。createVirtualCard现已接受。二者均默认为true（保留现有行为）。将二者均设为false可将卡片资金来源仅限制为指定的userCashBalanceId，不包含预付（礼品卡）与奖励资金。
- 新增
shortDescription（Merchant）与termsAndConditions（Offer）。现在由getMerchants和getOfferQuote返回。 - 新增
deliveryFormat（GiftCard）。现在由getGiftCards返回 —— 对已购卡使用deliveryFormat。
- 新增
getUserCashBalances和getUserCashBalanceById查询。这些查询允许用户检索其消费账户列表以及其账户上创建的特定消费账户。
分享虚拟卡 API
- 在“管理虚拟卡”下新增“分享虚拟卡”功能。请联系销售获取访问权限。
- 在应用程序 scope 页面新增
CREATE_SHARE_LINKscope。
企业注册 API
- 新增查询
getBusinessCategories: [BusinessCategory]以获取业务类别，响应类型为BusinessCategory和BusinessSubCategory。 - 新增变更
registerBusiness(input: RegisterBusinessInput!): RegisterBusinessResult用于以编程方式进行企业注册。 - 新增输入类型：
RegisterBusinessInput、BusinessLegalAddressInput、BusinessOwnerInput、OwnerAddressInput。 - 新增枚举：
BusinessStructure（LLC、CORPORATION、PARTNERSHIP、SOLE_PROPRIETORSHIP、COOP）与BusinessAccountUsage。 - 新增响应类型：
RegisterBusinessResult { accountId, kybStatus, success, error }与RegisterBusinessError { message, code }。 - 两个操作均需要具备
REGISTER_BUSINESSOAuth scope 的认证。
对
getMerchants 查询的更新getMerchants查询现在能正确返回所有可用的优惠。getMerchants查询现在可在offers对象中返回exclusiveRateId字段。该值可用于purchaseGiftCard以指定要购买的专属费率优惠。
提现与消费账户 APIs
- 新增
withdrawCashBalance变更，需具备MAKE_WITHDRAWALscope。 - 新增
WithdrawMethods枚举，支持PAYPAL、BANK_ACH、BANK_CARD和VENMO方法。 - 新增
WithdrawSource枚举，支持CASH_BALANCE和REWARDS_BALANCE来源。 - 新增带幂等支持的
WithdrawCashBalanceInput，以及包含完整提现记录详情（费用、状态与时间戳）的Withdraw与WithdrawCashBalanceResponse类型。 - 新增
transferUserCashBalance变更，需具备MAKE_INTERNAL_TRANSFERscope，并新增TransferInternalBalanceInput与TransferInternalBalanceResponse类型。 - 在
EditVirtualCardInput中新增userCashBalanceId，以便通过editVirtualCard将资金来源更改为指定的消费账户。 - 在
TransactionFilterInput中新增userCashBalanceIds用于通过getTransactions按消费账户过滤交易，并在getGiftCards中新增userCashBalanceId用于按消费账户过滤礼品卡。 - 新增
updateUserCashBalance和closeUserCashBalance变更，需具备MANAGE_PAYMENTscope，并新增支持的输入与响应类型（UpdateUserCashBalanceInput、CloseUserCashBalanceInput、CloseUserCashBalanceResponse、ClosedUserCashBalance、CloseUserCashBalanceResponseVirtualCard）。 - 新增应用程序操作日志以用于审计追踪。
- 在
getWallet查询的UserBalances类型中新增userCashBalances字段。通过paginate（limit/offset）分页返回单个用户现金余额账户的详细信息，按创建时间倒序排列。包含userCashBalanceId、totalCashBalance、availableCashBalance、lifetimeCashBalance、nickname、status和createdAt—— 支持跟踪每位用户的多个现金余额账户，带自定义昵称与状态监控。
- 在
DepositCashBalanceInput中新增字段userCashBalanceId，用于指定要存入资金的现金余额（消费账户）。
- 新增用于管理已保存银行卡的变更：
updateBankCardNickname、updateBankCardPreferredMerchantCategoryCode和deleteBankCard，及其对应的输入类型。 - 在
BankCard类型新增nickname字段。 - 在
AddBankCardInput中新增可选字段：nickname与preferredMerchantCategoryCode（MCC，标准化为 4 位）。
getVirtualCardBalance：新增查询，检索一组虚拟卡的余额信息，包括spentAmount、remainingBalance、spendLimit和spendLimitDuration。getVirtualCardTransactions：新增查询，检索一组虚拟卡的交易，支持诸如transactionTypes等过滤器。
getUserPurchases查询现在支持通过新增的可选变量UserPurchaseFilterInput来过滤返回的购买记录。可按用户、账户或两者筛选购买记录。
revealVirtualCardByVirtualCardId变更的响应现包含新的authorizationSetting字段。- 批量虚拟卡 API：用于异步创建和管理大量虚拟卡的新 API。
createVirtualCardBulkOrder变更：提交批量订单并接收唯一的orderId。getVirtualCardBulkOrderStatus查询：轮询以跟踪订单状态并在完成后获取卡详情。- 批量制卡过程是异步的 —— 请检查订单状态以获取卡详情。
- 新增查询
getVirtualCardOffers：提供所有可用于创建的在售虚拟卡优惠的完整列表，包括offerId（制卡所必需）、programName、bankName、rewardValue以及详细的项目限额（每日、每周、每月消费限额）。 - 更新变更
createVirtualCard：通过提供offerId（来自getVirtualCardOffers）、spendLimit，以及可自定义属性如cardNickname与spendLimitDuration，以编程方式发行虚拟卡。 - 新增变更
editVirtualCard：更新现有虚拟卡的关键参数 ——spendLimit、spendLimitDuration、lockDate、lockCardNextUse和cardNickname。 - 新增变更
lockVirtualCard：立即锁定虚拟卡，阻止任何后续交易。
getMerchants响应中的Offer类型现包含deliveryFormat字段，用于指定优惠的履约方式：URL、CODES、PIN_AS_CODE或PIN_WITH_URL。getMerchants查询新增filterBy参数，允许你将结果过滤为仅包含具有特定deliveryFormat的优惠的商户。
- 增强
getMerchants查询，新增offerTypes输入参数，允许按giftCardOffer、cardLinkedOffer或两者进行过滤。默认情况下，如果未提供offerTypes，查询仅返回礼品卡优惠。
- 引入新查询
getReferralUrl，根据商户输入返回推荐字符串，并新增MerchantInput类型。 - 为
purchaseGiftCard变更引入自动重购尝试。如果使用银行卡、银行账户或 PayPal 购买礼品卡失败，系统会自动尝试使用 Fluz 余额重新购买。 - 在
PurchaseGiftCardInput中引入defaultToBalance字段，用于在主要支付方式失败时将 Fluz 余额设为备用支付方式。默认值为true。
- 引入新的访问 scope：
CREATE_VIRTUALCARD，用于创建虚拟卡。 - 引入新函数
createVirtualCard，可按特定参数创建虚拟卡。 - 新增查询
getBINs，用于检索与虚拟卡关联的 BIN。 - 为现金余额充值引入
merchantCategoryCode输入，以增强交易分类。 - 新增查询
getMccList，用于检索商户类别码列表。 - 增强
getApplicationScopes查询的 scope 校验并改进 GraphQL 类型定义管理。
- 增强商户优惠的库存信息处理：
Offer对象的stockInfo字段现在会根据优惠是固定还是可变，返回StockInfoFixedType或StockInfoVariableType。 - 增强错误处理，提供更直观的错误消息响应 —— 改进了
purchaseGiftCard无可用优惠错误与账户与支付方式不匹配的响应。
v0.0.21
- 为
depositCashBalance和purchaseGiftCards引入idempotencyKey参数，以防止重复请求。 - 添加
purchaseGiftCardInput类型，以简化交易的参数处理。 - 在
UserPurchase类型中引入新字段purchaseDisplayId，用于提供购买的显示 ID。 - 修复
Offer对象的offeringMerchantId字段，使其返回offering_merchant_id而非offer_id。
- 为
generateUserAccessToken新增accountId要求。 - 实现新查询
getAccountsByUserId，用于基于userId获取账户。 - 新增
AccountType枚举以将账户分类为CONSUMER或BUSINESS，并新增Account、Business与Seat对象。
- 修复
depositCashBalance的平台渠道输入，使充值交易日志来源记录为API。