- 新增 Plaid Link 支援。
- 使用
llms.txt資訊更新 Overview 頁面。 - 使用指向
llms.txt的 AI 連結更新頁首。
- 新增
getCardProvisioningUrlquery — 產生一個短效、一次性使用的 URL，於行動裝置開啟時會啟動 Fluz，並將虛擬卡加入 Apple Pay（iOS）或 Google Pay（Android）。可透過 QR code、SMS、電子郵件或應用內按鈕呈現。每個 URL 於建立後約 5 分鐘到期。需要CREATE_VIRTUALCARD範圍。 - 新增輸入
GetCardProvisioningUrlInput { offerId, platform }。 - 新增列舉
ProvisioningPlatform（IOS|ANDROID|OTHER）— 僅控制桌面／未知裝置的後備流程；iOS 與 Android 的開啟會自動導流。 - 新增回傳型別
CardProvisioningUrl { url, expiresAt }。
- 新增
addVirtualCardAddressmutation，用於儲存虛擬卡發卡所需的帳單地址。 - 更新
createVirtualCardmutation 以支援代授權使用者建立卡片。 - 新增完整流程，使用
registerUser、addAuthorizedUser、addVirtualCardAddress與createVirtualCard。 - 對於待處理的發卡方審批，可使用
VC-0020與回傳的addressId重試。
redeemFluzGiftCard— 使用代碼兌換 Fluz Gift Card。入帳至giftCardCashBalance。需要MAKE_DEPOSIT。請參閱 兌換 Fluz Gift Card。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現可為 nullable。 - 於
CreateVirtualCardInput新增usePrepaymentBalance與useRewardsBalance。createVirtualCard現接受這兩者。兩者預設為true（維持既有行為）。同時將兩者設為false可限制卡片僅自指定的userCashBalanceId扣款，不含預付（禮品卡）與獎勵資金。
- 新增
shortDescription（Merchant）與termsAndConditions（Offer）。現由getMerchants與getOfferQuote回傳。 - 新增
deliveryFormat（GiftCard）。現由getGiftCards回傳 — 對已購買的卡片使用deliveryFormat。
- 新增
getUserCashBalances與getUserCashBalanceByIdqueries。這些查詢允許使用者擷取其消費帳戶清單以及在其帳戶上建立的特定消費帳戶。
分享虛擬卡 API
- 在管理虛擬卡下新增「分享虛擬卡」功能。請聯絡銷售以取得存取權。
- 於 應用程式範圍 頁面新增
CREATE_SHARE_LINK範圍。
企業註冊 API
- 新增查詢
getBusinessCategories: [BusinessCategory]以擷取企業類別，並提供回應型別BusinessCategory與BusinessSubCategory。 - 新增 mutation
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 範圍進行驗證。
getMerchants 查詢更新getMerchants查詢現在能正確回傳所有可用的 offers。getMerchants查詢現在可回傳exclusiveRateId欄位（位於offers物件內）。此值可於purchaseGiftCard中指定你要以專屬費率購買的 offer。
提領與消費帳戶 API
- 新增
withdrawCashBalancemutation，需具備MAKE_WITHDRAWAL範圍。 - 新增
WithdrawMethods列舉，支援PAYPAL、BANK_ACH、BANK_CARD與VENMO方法。 - 新增
WithdrawSource列舉，支援CASH_BALANCE與REWARDS_BALANCE來源。 - 新增具冪等性支援的
WithdrawCashBalanceInput，以及完整提領紀錄細節（含費用、狀態與時間戳）的Withdraw與WithdrawCashBalanceResponse型別。 - 新增
transferUserCashBalancemutation，需具備MAKE_INTERNAL_TRANSFER範圍，並包含TransferInternalBalanceInput與TransferInternalBalanceResponse型別。 - 於
EditVirtualCardInput新增userCashBalanceId，可透過editVirtualCard將資金來源變更為指定的消費帳戶。 - 於
TransactionFilterInput新增userCashBalanceIds以透過getTransactions依消費帳戶篩選交易，並於getGiftCards新增userCashBalanceId以依消費帳戶篩選禮品卡。 - 新增
updateUserCashBalance與closeUserCashBalancemutations，需具備MANAGE_PAYMENT範圍，並包含支援的輸入與回應型別（UpdateUserCashBalanceInput、CloseUserCashBalanceInput、CloseUserCashBalanceResponse、ClosedUserCashBalance、CloseUserCashBalanceResponseVirtualCard）。 - 新增應用程式動作記錄以供稽核追蹤。
- 在
getWallet查詢的UserBalances型別中新增userCashBalances欄位。透過paginate（limit/offset）提供分頁，並依建立日期排序（最新優先），回傳個別使用者現金餘額帳戶的詳細資訊。包含userCashBalanceId、totalCashBalance、availableCashBalance、lifetimeCashBalance、nickname、status與createdAt— 可用於追蹤每位使用者的多個現金餘額帳戶、客製暱稱與狀態監控。
- 在
DepositCashBalanceInput新增userCashBalanceId欄位，以指定要存入資金的現金餘額（消費帳戶）。
- 新增管理已儲存銀行卡的 mutations：
updateBankCardNickname、updateBankCardPreferredMerchantCategoryCode與deleteBankCard，以及相應的輸入型別。 - 在
BankCard型別新增nickname欄位。 - 在
AddBankCardInput新增選填欄位：nickname與preferredMerchantCategoryCode（MCC，正規化為 4 位數）。
getVirtualCardBalance：新的查詢，可擷取一組虛擬卡的餘額資訊，包括spentAmount、remainingBalance、spendLimit與spendLimitDuration。getVirtualCardTransactions：新的查詢，可擷取一組虛擬卡的交易，並提供如transactionTypes等篩選條件。
getUserPurchases查詢現在可透過新的選填變數UserPurchaseFilterInput來篩選回應中的購買紀錄。可篩選由使用者、帳戶或兩者所發起的購買。
revealVirtualCardByVirtualCardIdmutation 的回應現在包含新增的authorizationSetting欄位。- 大量虛擬卡 API：新的 API，可非同步建立與管理大量虛擬卡。
createVirtualCardBulkOrdermutation：提交大量訂單並取得唯一的orderId。getVirtualCardBulkOrderStatusquery：透過輪詢追蹤訂單狀態，並於完成後擷取卡片詳細資料。- 大量卡片建立流程為非同步 — 請檢查訂單狀態以擷取卡片詳細資料。
- 新查詢
getVirtualCardOffers：完整列出可供建立的所有有效虛擬卡 offer，包括offerId（建立卡片所必需）、programName、bankName、rewardValue，以及詳細的方案限制（每日、每週、每月消費上限）。 - 更新 mutation
createVirtualCard：透過提供offerId（來自getVirtualCardOffers）、spendLimit，以及可自訂的屬性如cardNickname與spendLimitDuration，以程式化方式發行虛擬卡。 - 新 mutation
editVirtualCard：更新現有虛擬卡的關鍵參數 —spendLimit、spendLimitDuration、lockDate、lockCardNextUse與cardNickname。 - 新 mutation
lockVirtualCard：立即鎖定虛擬卡，阻止任何後續交易。
getMerchants回應中的Offer型別現在包含deliveryFormat欄位，用以指定 offer 的履行方式：URL、CODES、PIN_AS_CODE或PIN_WITH_URL。getMerchants查詢已強化，新增filterBy參數，允許你僅篩選出其 offers 符合特定deliveryFormat的商家。
- 強化
getMerchants查詢，新增offerTypes輸入參數，允許依giftCardOffers、cardLinkedOffers 或兩者皆有來篩選。預設情況下，若未提供offerTypes，查詢僅回傳禮品卡 offers。
- 新增查詢
getReferralUrl，根據商家輸入回傳推薦字串，並新增MerchantInput型別。 - 於
purchaseGiftCardmutation 新增自動重購嘗試。若使用銀行卡、銀行帳戶或 PayPal 購買禮品卡失敗，系統會自動嘗試改用 Fluz 餘額重購。 - 於
PurchaseGiftCardInput新增defaultToBalance欄位，以在主要付款方式失敗時將 Fluz 餘額設為後備付款方式。預設為true。
- 新增存取範圍
CREATE_VIRTUALCARD，用於建立虛擬卡。 - 新增函式
createVirtualCard，可用特定參數建立虛擬卡。 - 新增查詢
getBINs，以擷取與虛擬卡相關的 BIN。 - 在現金餘額存款中新增
merchantCategoryCode輸入，以強化交易分類。 - 新增查詢
getMccList，以擷取商家類別代碼清單。 - 強化
getApplicationScopes查詢的範圍驗證，並改進 GraphQL 型別定義管理。
- 強化商家 offer 的庫存資訊處理：
Offer物件的stockInfo欄位現在會視 offer 為固定或可變而回傳StockInfoFixedType或StockInfoVariableType。 - 強化錯誤處理，提供更直覺的錯誤訊息回應 — 改進
purchaseGiftCard無 offer 錯誤與帳戶與付款方式不相符的回應。
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。