Skip to main content
重點摘要：你不需要知道任何關於收件者的資訊就能產生卡片。只有當你希望由 Fluz 負責傳遞時，才需要收件者的聯絡資料。若由你自行傳遞連結，你只需提供卡片限額、優惠與資金帳戶——不需要其他資訊。收件者會在託管頁面上自行填寫資料。

​
選擇你的方式

1

要由 Fluz 傳遞連結，還是由你來？

若你自行傳遞——透過你自己的 Email、你自己的簡訊、App 內、入口網站，或將 URL 交給下游客戶——使用 GENERATE_URL。不需提供收件者資料。
2

若由 Fluz 傳遞，要用哪種方式？

Email（EMAIL）或簡訊（PHONE_NUMBER）。你需為每張卡提供一個地址或號碼。
3

你是否已持有收件者的完整身分資訊？

若是——且你希望收件者完全略過資料輸入——請向你的 Fluz 窗口洽詢 預先填入式註冊。此為受控選項，不屬於標準的 generateVCShareLinks 流程。

​
四種選項一覽

選項 1–3 都是同一個 mutation 上 shareMethod 欄位的三個值。彼此切換只需改一行——你不是在整合三個不同的 API。

​
選項 1 — 產生連結，由你傳遞

大多數合作夥伴都選這個。 你呼叫 API，取得一組 URL 陣列，接著可任意處理：用你自己的系統寄信、發簡訊、放進客戶入口網站，或交給下游客戶，再由他們分送給最終使用者。 Fluz 不會向任何人寄送任何東西。對於這些連結，我們沒有任何收件者聯絡資料，因為你從未提供給我們。
Generate URLs
Response
使用 GENERATE_URL 時，recipientListEmail 與 recipientListPhone 必須留空或省略。在 GENERATE_URL 下同時送出收件者清單會導致驗證錯誤，且不會建立任何紀錄。
將 quantity 設為大於 1，可在一次呼叫中鑄造一批。你會得到每單位一個獨立 URL，而且每個 URL 僅能被認領一次。請依原樣分發這些 URL——不要重寫或再次縮網址。

​
選項 2 — 由 Fluz 寄送 Email 連結

你為每張卡提供一個 Email，Fluz 會寄出 Email。收件者點擊後會進入與選項 1 相同的託管頁面，並在該處自行輸入資料。 當你已持有收件者 Email，且不想自行建立傳遞流程時可使用此方法。
Email
recipientListEmail 的長度必須等於 quantity。不一致將回傳驗證錯誤，且不會建立任何紀錄——不會產生部分批次。

​
選項 3 — 由 Fluz 傳送簡訊連結

與選項 2 類似，但透過 SMS。你需以 E.164 格式提供每張卡一個電話號碼。Fluz 會發送簡訊；在此路徑上 Fluz 不會另外寄送 Email。
SMS
recipientListPhone 的長度必須等於 quantity，且兩個清單互斥——請送出與 shareMethod 相符的清單，並將另一個留空。

​
選項 4 — 預先填入式註冊

有些合作夥伴會希望提供更高端的體驗，讓收件者完全不必輸入任何資料。在此模式中，你會將卡片註冊所需的身分資訊傳給 Fluz，而收件者唯一要做的就是開啟連結並領取卡片。 這是受控選項，不屬於標準的 generateVCShareLinks 輸入內容。若你的專案需要此功能，請與 Fluz 客戶團隊洽談——因為你會代表尚未與 Fluz 互動的人提供個人資訊，這在你方會帶來額外的資料處理與合規義務。
僅在你確實持有經驗證的收件者身分資料時才選擇此法。若你只是為了避免向收件者索取資訊而傾向選項 4，幾乎可以確定選項 1 才是你真正需要的。

​
收件者會做什麼

在選項 1–3 之間完全相同。無論由誰傳遞，連結都會前往相同的託管頁面：
1

開啟連結

無需下載 App、無需 Fluz 帳號、無需密碼。
2

以手機驗證

一次性驗證碼用來確認持有連結的人。
3

輸入卡片資料

收件者提供卡片所需的資料。此階段不會要求輸入 PIN。
4

領取、揭露、並消費

卡片資金會在收件者領取時自你的消費帳戶撥款，而非在產生連結時。收件者將成為該張卡片物件的授權使用者——不包含你帳戶上的其他任何東西。卡片在領取後不會自動揭露：揭露時會提示收件者輸入其 PIN，或若尚未設定則先建立 PIN。
完整流程與當連結過期、被撤銷或已被領取時的狀態，請參考收件者體驗。

​
常見疑惑

不需要。那是對 API 參考文件的常見誤讀。收件者欄位是為了讓 Fluz 能代你傳遞——它們不是卡片發行的輸入項。使用 GENERATE_URL 時你完全不會送出任何收件者資料。
不必。只有在 shareMethod = EMAIL 時才必須提供 recipientListEmail。在 GENERATE_URL 與 PHONE_NUMBER 下，它必須為空。
可以——這正是 GENERATE_URL 的使用模式。此 URL 為持有人式：誰先開啟並完成驗證，誰就領取該卡。請將連結視為敏感資訊，透過你信任的通道傳遞。
目前不行。連結產生僅支援 API。請使用具有 CREATE_SHARE_LINK 權限範圍的 Staging 權杖在測試環境進行測試——參見Staging 與正式環境。
可以。shareMethod 是針對每次呼叫設定，不是針對帳戶。你完全可以先產生一批 URL，再讓 Fluz 寄送下一批。

​
所有方式的共通需求

​
下一步

Open Loop Cards Overview

產生、列出與停用連結的完整操作參考。

Recipient Experience

收件者所見內容，以及其卡片所適用的規則。