Skip to main content
標準託管連結流程 會把所有動作交給收件人：你建立一個連結，Fluz 只會在收件人開啟連結、完成驗證並認領後，才建立虛擬卡。 此流程則反轉了這點，適用於你已經識別的收件人。你先用 registerUser 自行註冊收件人的身分與帳單地址，然後用 generateVCShareLinks 並指定 shareMethod: EXISTING_USER 產生分享連結。Fluz 會在產生連結的當下就立即建立虛擬卡，而不是在認領時，並且將卡片綁定到該唯一收件人。連結的傳遞與認領仍照一般方式進行；只有卡片建立的時間提前。資金仍在認領時扣款，和標準流程相同——優先從 userCashBalanceId 扣款；若消費帳戶餘額不足，且已啟用，則回退使用你的預付或獎勵餘額。
何時使用此流程而非一般分享連結
  • 你已明確知道收件人是誰（以使用者 ID 辨識），並希望在通知他們之前就先把卡片建立好，不用等他們來認領。
  • 你需要嚴格保證只有預期的收件人能查看連結，而不是「第一個點擊的人」。
  • 你要寄送給一批已知收件人，並需要收件人與卡片之間可預期的一對一對應。

​
開始之前

你需要 Bearer 存取權杖。這兩個操作都不接受基本認證（Basic auth）。
使用者註冊並非預設啟用。 registerUser 是受限的 mutation——你的應用程式必須先經 Fluz 明確核准，才能建立使用者。請聯絡你的 Fluz 業務代表或客戶經理以啟用此功能。 來自未核准應用的呼叫將以 AUTH-0022 失敗。若收件人已擁有 Fluz 帳號，你可以略過註冊，直接在 generateVCShareLinks 中提供現有的 recipientUserIds。
參見 Authentication 了解如何建立具範圍的權杖。 示範 open loop cards

​
與標準流程的差異

標準流程請見 Send Open Loop Cards，完整認領流程請見 Recipient Experience。

​
注意事項與限制

  • recipientUserIds 必須參照現有的 Fluz 使用者。 若收件人尚未註冊，請先用 registerUser 註冊（本流程），或改用標準託管連結流程，讓 Fluz 在認領時為其辦理入門引導。
  • recipientUserIds 長度必須等於 quantity。 若不相符將回傳驗證錯誤，且不會建立任何紀錄。
  • 卡片建立提前至連結產生時——資金扣款則沒有改變。 當你呼叫 generateVCShareLinks 時，會建立虛擬卡物件與收件人綁定，但資金仍在認領時扣款，與標準流程相同：優先從 userCashBalanceId，若消費帳戶不足且有設定 usePrepaymentBalance / useRewardsBalance，則回退使用你的預付或獎勵餘額。
  • 註冊權限以應用程式與環境為界。 在測試環境獲授權不代表正式環境也有。請見 Deploying to Production。
  • 切勿在測試環境註冊真實個人。 請見 Staging vs. Live。

​
後續步驟

Send Open Loop Cards

標準流程——產生連結並在認領時由 Fluz 發卡。

Recipient Experience

收件人開啟並認領託管連結時所見的體驗。

Register Customers

registerUser 的完整參考，包含錯誤處理與回退模式。