- 交易中的數位錢包訊號。
TRANSACTION_CREATE與TRANSACTION_UPDATEwebhook 事件，以及getTransactionsAPI，現在包含digitalWalletProvider（APPLE_PAY、GOOGLE_PAY，或缺席）以便辨識卡片交易是否透過行動錢包進行，另有digitalWalletToken（網路代幣 ID）。請使用digitalWalletProvider作為錢包使用的判斷訊號——digitalWalletToken也會在非錢包的網路代幣情境設置，因此僅憑其存在不代表使用了錢包。為新增且相容的變更。參見 Webhooks。
- 開環卡（Open Loop Cards）：收件人在初始啟用流程中不再被要求建立 PIN，且在領取時不會自動顯示卡片。現在在顯示卡片時，系統會提示收件人輸入其 PIN，若尚未設定 PIN，則會提示建立 PIN。參見 收件者體驗。
- 更新 Open Loop Cards 的 GenerateVCShareLinksInput。參見 Open Loop Cards。
GiftCard.purchaseId(UUID) — 建立該禮品卡的購買紀錄；與purchaseGiftCard與getUserPurchases回傳的相同 ID。若無關聯購買則回傳null。GiftCard.purchaseDisplayId(String) — 簡短、易讀的 Fluz 交易 ID（例如1047283），支援在人工審查與匯出中引用。若無關聯購買則回傳null。GiftCard.purchaseValue(Float) — 禮品卡購買時的面額，以該卡的貨幣計價。GiftCard.currentValue(Float) — 禮品卡的剩餘餘額；對於單次使用卡等於purchaseValue。GiftCard.currency(String) — 禮品卡價值的 ISO 貨幣代碼（例如USD）。
getGiftCards（以及任何暴露 GiftCard 的位置）都會回傳以上五個欄位，使你無需對每張卡呼叫 revealGiftCardByGiftCardId 也能進行訂單/金額對帳。為新增且相容的變更。- 加入 Plaid Link 支援。
- 在 Overview 頁面新增
llms.txt資訊。 - 在標頭加入導向
llms.txt的 AI 連結。
- 新增
getCardProvisioningUrl查詢 — 產生一個短且一次性使用的 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 }。
- 新增
addVirtualCardAddress變更，儲存用於發行虛擬卡的帳單地址。 - 更新
createVirtualCard變更，以支援代表授權使用者建立卡片。 - 新增完整流程，使用
registerUser、addAuthorizedUser、addVirtualCardAddress與createVirtualCard。 - 對於待處理的發卡機構審批（
VC-0020）與回傳的addressId，支援重試。
redeemFluzGiftCard— 使用代碼兌換 Fluz 禮品卡。入帳至giftCardCashBalance。需要MAKE_DEPOSIT。參見 兌換 Fluz 禮品卡。unlockVirtualCard— 解除先前鎖定的虛擬卡，恢復交易能力。需要EDIT_VIRTUALCARD。參見 解鎖虛擬卡。
交易相關的 webhooks
- 新增
TRANSACTION_CREATE、TRANSACTION_UPDATE與TRANSACTION_DECLINEwebhook 的描述。 - 加入 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
- 新增查詢
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 權限範圍進行驗證。
getMerchants 查詢更新getMerchants查詢現在會正確回傳所有可用的 offers。getMerchants查詢現在可在offers物件中回傳exclusiveRateId欄位。此值可在purchaseGiftCard中使用，以指定你要購買的獨家費率 offer。
提領與消費帳戶 API
- 新增
withdrawCashBalance變更，需具備MAKE_WITHDRAWAL權限範圍。 - 新增
WithdrawMethods列舉，支援PAYPAL、BANK_ACH、BANK_CARD與VENMO方法。 - 新增
WithdrawSource列舉，支援CASH_BALANCE與REWARDS_BALANCE來源。 - 新增具冪等性支援的
WithdrawCashBalanceInput，以及包含完整提領紀錄細節（費用、狀態與時間戳）的Withdraw與WithdrawCashBalanceResponse型別。 - 新增
transferUserCashBalance變更，需具備MAKE_INTERNAL_TRANSFER權限範圍，另有TransferInternalBalanceInput與TransferInternalBalanceResponse型別。 - 在
EditVirtualCardInput新增userCashBalanceId，以便透過editVirtualCard將資金來源更改為指定的消費帳戶。 - 在
TransactionFilterInput新增userCashBalanceIds，以便透過getTransactions依消費帳戶篩選交易；在getGiftCards新增userCashBalanceId，以便依消費帳戶篩選禮品卡。 - 新增
updateUserCashBalance與closeUserCashBalance變更，需具備MANAGE_PAYMENT權限範圍，並包含支援的輸入與回應型別（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：提供所有可用於建立的活動虛擬卡 offers 之完整清單，包括offerId（發卡必需）、programName、bankName、rewardValue，以及詳細的方案限制（每日、每週、每月的消費上限）。 - 更新變更
createVirtualCard：透過提供offerId（來自getVirtualCardOffers）、spendLimit，以及可自訂的屬性如cardNickname與spendLimitDuration，以程式化發行虛擬卡。 - 新增變更
editVirtualCard：更新既有虛擬卡的關鍵參數——spendLimit、spendLimitDuration、lockDate、lockCardNextUse與cardNickname。 - 新增變更
lockVirtualCard：立即鎖定虛擬卡，阻止任何後續交易。
getMerchants回應中的Offer型別現包含deliveryFormat欄位，用以指定 offer 的履約方式：URL、CODES、PIN_AS_CODE或PIN_WITH_URL。getMerchants查詢新增filterBy參數，允許你依指定的deliveryFormat僅回傳符合的商家。
- 強化
getMerchants查詢，新增offerTypes輸入參數，允許依giftCardOffers、cardLinkedOffers 或兩者進行篩選。若未提供offerTypes，查詢預設僅回傳禮品卡 offers。
- 新增查詢
getReferralUrl，會根據商家輸入回傳推薦字串，並新增MerchantInput型別。 - 在
purchaseGiftCard變更上導入自動再購機制。若使用銀行卡、銀行帳戶或 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。