tea.support 平台上的贈禮運作方式
禮品訂單在 THETEA 星系的技術骨幹與個人茶韻時刻的溫暖之間架起橋樑。無論您是整合我們禮品卡 API 的合作夥伴，或是在 tea.support 上建立白牌解決方案的開發者，禮品訂單流程都能讓您提供精心策劃的茶體驗 — 例如與資深茶專家方婷（Fang Ting）一同品鑑 Lǎobānzhāng（老班章）生普洱茶，或是在陳慧怡（Chen Hui Yi）的引導下，進行一場圍繞來自 Fuding 的 Bái Háo Yín Zhēn（白毫银针）的白茶儀式。機制很簡單：一筆已付費的點數，可在星系內的各項可預訂服務中使用（thetea.app、tea.school、tea.events 等）。在這份簡潔背後，有著精確的時間規則、訊息卡片格式和遞送選項，每個整合都需要妥善處理。
本常見問題解答了我們從建置贈禮流程的團隊那裡聽到的最常見問題：訂單最遲可以在收禮者計劃日期的多久前下訂？隨禮物附上的數位便箋有確切的字元限制嗎？當您想在生日當天早上 8 am 整給對方驚喜時，「保留等待遞送」選項如何運作？我們將每個答案視為一個積木 — 不誇大，只提供您讓使用者體驗順暢所需的事實細節。
由於禮品訂單涉及產品溯源與茶師可用性，您還會看到與更廣泛生態系的交叉引用。如需深入探討茶葉產地與工廠直送溯源，專屬的 puerh.app 知識庫是正確去處。若您想了解茶師的行程表如何管理，或想與其他開發者討論贈禮點子，tea.community 設有專屬頻道。讀完後，您應能清楚掌握時機、卡片和遞送的相關政策，並確切知道當情況超出文件範圍時該向何處諮詢。
常見問題
什麼是 tea.support 上的禮品訂單？
禮品訂單是一筆已付費的點數，可用於兌換 THETEA 星系內任何可預訂的茶體驗 — 茶會、品鑑行程或線上課程。合作夥伴使用 tea.support API 建立一個包含貨幣價值、個人化訊息（選填）和收禮者電子郵件的訂單。訂單本身不會預訂特定日期；它讓收禮者自由安排時間。你可以把它想成一張圍繞著真實茶師工作的數位禮品卡。
訂單最遲可以在預定遞送時間的多久前下訂？
API 沒有強制性的截止時間 — 訂單是數位的，會即時傳送。然而，若送禮者希望收禮者用於當天的現場活動，我們建議至少提前 4 小時下訂，因為多數茶師需要 2 小時的通知才能安排，而且收禮者也需要一小段時間來預約。對於自動化流程，請在任何日曆日期上以 6 小時作為安全緩衝。平台絕不會拒絕較晚的訂單；實際的後勤作業才是真正的限制。
禮品訊息卡片的字元上限是多少？
message 欄位最多接受 280 個字元，包含空格和標點符號。超過部分 API 會靜默截斷 — 我們建議在前端進行驗證，以免意外截斷。該欄位支援 Unicode，因此拼音變音符號（Lǎobānzhāng）和表情符號都能正確呈現在最終的數位卡片上。如果需要更長的個人留言，可以連結到外部文件；卡片本身設計成一份溫暖簡短的簽名。
我可以安排禮物在未來的特定日期和時間傳送嗎？
可以，透過 scheduled_delivery 參數（ISO 8601 時間戳記，UTC）。您可以設定最多 90 個日曆天後的時間。到了排定的時刻，系統會發送禮品電子郵件並啟用點數。您可以用這個功能來慶祝生日、週年紀念或節氣主題的茶禮 — 例如在清明節當天送上一場春季 Lóngjǐng（龙井）體驗。
如果收禮者一直未領取禮物會怎樣？
未領取的禮品點數自購買日起 365 天內有效，逾期後點數將失效，款項將視為捐贈給 THETEA 茶獎學金基金。我們會在到期前 30 天和 7 天通知購買人與收禮者。如果您需要對一份未領取且未逾期的禮品全額退款，適用標準的 14 天退款期（請見取消問題）。
我可以取消禮品訂單並獲得退款嗎？
您可以在購買後 14 個日曆天內申請全額退款，前提是禮品點數尚未被兌換或部分使用。過了 14 天後，不再提供退款，但點數對收禮者仍有效。退款將於 5 個工作日內退還至原始付款方式。對於整合方案，請使用 refund 端點並傳入原始訂單 ID。
在 API 整合中，「保留等待遞送」選項如何運作？
將 delivery_mode 設為 hold，並提供一個 release_key（由您的系統選擇的唯一字串）。禮品會保持休眠狀態，直到您以該金鑰呼叫 release 端點為止。這讓您可以將釋放動作與外部事件綁定 — 例如實體禮品卡拆封或特定的網址造訪。保留狀態最多可持續 180 天；之後禮品照常失效。
禮品訂單可指定特定的茶體驗，還是只能用一般點數？
兩種都可以。純點數就像星系通用的禮券。或者，您可以將禮品鎖定在特定的 SKU — 例如，由方婷策劃的 Lǎobānzhāng 生普洱私人品鑑。鎖定會將點數限制在該體驗上，簡化定價，並確保收禮者看到您原本的用意。API 參數是 experience_sku；留空則為開放點數。
禮品訂單接受哪些付款方式？
tea.support 平台接受信用卡（Visa、Mastercard、銀聯卡）和數位錢包（支付寶、微信支付）。對於合作夥伴整合方案，資金會以您選擇的幣別每日結算。禮品訂單不可以開立發票 — 必須預付才能產生有效的點數。如果您需要批次購買發票且不在 API 流程內，請透過 tea.support/partners 聯繫合作團隊。
收禮者如何兌換禮物？
他們會收到一封包含安全兌換連結和唯一代碼的電子郵件。連結會引導到一個品牌頁面，在那裡他們可以瀏覽可用場次、選擇茶師和時間段，並使用點數。無論禮品是開放點數還是鎖定 SKU，兌換方式都一樣；鎖定的禮品會跳過瀏覽步驟，直接進入排程。收禮者可以在該頁面看到個人訊息卡。
禮品點數會過期嗎？
會，自購買日起 365 天後。此過期規定同時適用於開放點數和鎖定體驗的禮品。一旦過期，點數無法恢復。我們會在收禮者資訊主頁上顯示過期日期，並發送兩封提醒郵件（到期前 30 天和 7 天）。如果您需要為特定收禮者延長期限，請在過期日前將訂單 ID 透過 api‑support@tea.support 聯繫我們。
我可以同時向同一位收禮者發送多筆禮品訂單嗎？
沒有技術上的限制。您可以使用相同的收禮者電子郵件建立任意數量的訂單。每個訂單會產生各自的兌換代碼和點數餘額。如果您希望收禮者看到合併的單一總額，則必須在您自己的系統端處理，因為 tea.support 帳本將每個訂單視為獨立個體。
如何在禮品訊息中處理特殊字元、拼音或茶名？
訊息欄位採用 UTF‑8 編碼。所有 Unicode 碼位都接受，包括呈現準確拼音所需的變音符號，例如 Bái Háo Yín Zhēn。表情符號和罕用中文字在電子郵件和兌換頁面上都能正確顯示。請在用戶端驗證輸入長度（280 個字元），如果您是在伺服器端範本中嵌入 JSON，請記得跳脫引號。訊息不會被解析，只會直接顯示。
如果禮品鎖定的茶師無法提供服務，會發生什麼事？
禮品點數仍然有效。如果茶師的行事曆已滿或退出，系統會提示收禮者選擇具備相似專長的其他茶師 — 例如，如果方婷無法主持普洱茶會，周翔（Zhou Xiang）可以接手。這項替換是由排程引擎自動完成；禮品本身不會因為單一茶師的不可用而過期。合作夥伴可以透過 API 自訂備援邏輯。
高價值的禮品體驗提供訂金或分期付款選項嗎？
對於標準禮品訂單，必須全額預付 — 公開 API 中沒有訂金機制。然而，針對精心策劃的企業贈禮方案（最低消費 ¥20,000），合作團隊可以安排 30% 訂金，餘額於首次排定場次前 14 天付清。請聯繫 gift‑enterprise@tea.support 洽談；此流程不透過自助式 API 提供。
仍有疑問？
tea.support API 文件（tea.support/docs）詳細說明了上述每個端點，並提供互動式範例。如果有情況不符上述說明 — 例如，要求對已部分兌換的禮品退款，或為白牌整合方案自訂過期政策 — 最佳途徑是發送電子郵件至 api‑support@tea.support。平日回覆時間在一個工作日內。
如需即時系統狀態與事件報告，請將 tea.support/status 加入書籤。想討論禮品訂單模式或分享回饋的建置者，常會加入 tea.community 上的 #gifting 頻道；那是星系中最活躍的空間之一。如果您正在探索哪些茶體驗可能成為最難忘的禮物，thetea.app 和 tea.events 上的精選型錄能提供靈感與直接預訂連結。而對真正好奇的人來說，本文提及的每款茶葉背後的故事——從 Lǎobānzhāng 的石壓餅到 Bái Háo Yín Zhēn 的白毫——都收錄在 puerh.app 以及 tea.school 的茶師簡介中。
禮品訂單是 THETEA 體系中一條微小卻重要的線索。我們希望這些解答能為您節省時間，並隨時歡迎根據實際使用情況加以完善。