商家資料表
| 欄位名稱 | 限制 | 說明 | 資料表 |
|---|---|---|---|
merchant_name | Text | 這是特定禮品卡商家的名稱。若你呼叫的目錄會同時顯示同一商家的固定與可變面額優惠，則每一種優惠類型都會在該商家下有一筆獨立紀錄。 | Merchant |
merchant_slug | Text | 這是商家的縮短名稱。可用於透過 API 將購買資料傳遞給 Fluz 的特定商家。同時也用於在 Fluz 網頁應用程式上產生商家 URL。URL 結構為 https://fluz.app/store/merchant_slug | Merchant |
updated_at | Date, time stamp | 該商家資料表紀錄的最後更新時間 | Merchant |
created_at | Date, time stamp | 此商家加入我們目錄的日期 | Merchant |
merchant_status | Active or Inactive | 指示此商家目前是否可供購買。商家狀態可以是啟用或停用。若商家被封存，將會從目錄匯出中完全移除。 | Merchant |
logo_url | URL | 商家標誌的圖片。這會是商家標誌的正方形圖片，為 300 x 300 像素的向量圖。 | Merchant |
faceplate_image | JSON | 不同尺寸禮品卡圖片的 JSON 物件。這些是商家提供的官方禮品卡圖片。 | Merchant |
primary_color | Hex Code | 為了在你的體驗中呈現，Fluz 會提供商家標誌圖片的主色。 | Merchant |
type | Gift Card or Card Linked Offer | Fluz 同時提供禮品卡優惠與卡片連結優惠。這取決於特定商家。每個商家可以有任一選項。此欄位會確認優惠類型是禮品卡優惠或卡片連結優惠。 | Merchant |
category | List | 這是商家在整體 Fluz 目錄中的分類對應。 | Merchant |
daily_limit-consumer | Number | 在單一天內，單一商家可購買的最高金額上限。此為註冊為消費者帳戶的單一使用者帳戶。日曆天以 UTC 時區運行，限額每日重置。 | Merchant |
daily_limit-commercial | Number | 在單一天內，單一商家可購買的最高金額上限。此為註冊為商業帳戶的單一使用者帳戶。日曆天以 UTC 時區運行，限額每日重置。 | Merchant |
monthly_limit-consumer | Number | 在單一日曆月內，單一商家可購買的最高金額上限。此為註冊為消費者帳戶的單一使用者帳戶。日曆月以 UTC 時區運行，從每月第一天至該月最後一天，限額每月重置。 | Merchant |
monthly_limit-commercial | Number | 在單一日曆月內，單一商家可購買的最高金額上限。此為註冊為消費者帳戶的單一使用者帳戶。日曆月以 UTC 時區運行，從每月第一天至該月最後一天，限額每月重置。 | Merchant |
website_url | URL | 此特定商家的 URL。請注意，若商家有多個 URL 或子網域，Fluz 會僅提供該商家的單一 URL。 | Merchant |
redemption_information | Text | 關於如何在該特定商家兌換禮品卡的詳細資訊。這些可以是特定規範 | Merchant |
parent_company | Text | 若特定商家的禮品卡可用於其他零售品牌，我們會列出母公司的名稱 | Merchant |
redeemable_at_other_brands | List | 此禮品卡可在哪些其他商家兌換。有時是同一母公司底下的其他子商家；其他時候則可能是多品牌卡可使用的一系列商家。 範例： Uber 禮品卡可於 Uber + Uber Eats 兌換 Gap 禮品卡可於 Gap + Old Navy + Banana Republic + Athleta 兌換 Happy Card Retail Therapy 卡可於 Lululemon、Macys、Nike、Boohoo 等兌換 | Merchant |
merchant_gift_card_redemption_url | Text | 若商家有特定的 URL 可將禮品卡餘額直接套用至你在該商家的帳戶，該特定 URL 會在此欄位提供。 | Merchant |
description | Text | 商家的完整詳細描述。 | Merchant |
short_description | Text | 該商家描述的精簡版本。 | Merchant |
merchant_support_phone_number | Phone Number | 若商家提供專門處理其禮品卡計畫支援問題的電話號碼，會在此提供。 | Merchant |
merchant_support_email | Email address | 若商家提供專門處理其禮品卡計畫支援問題的電子郵件地址，會在此提供。 | Merchant |
優惠資料表
| 欄位名稱 | 限制 | 說明 | 資料表 |
|---|---|---|---|
offer_id | UUID | 這是你將參考使用的公開優惠 ID | Offer |
rate | number | 這是該商家上的最佳回饋率。 若固定與可變面額具有相同回饋率，則只需包含可變面額。 若可變面額的回饋率低於固定面額，請同時包含可變與固定面額優惠，除非你呼叫的是僅含可變面額優惠的目錄。 若商家有多個不同面額的固定面額優惠且回饋率不同，則每個面額 + 回饋率組合都會有一筆獨立優惠。 | Offer |
denomination_type | Fixed or Variable | 此欄位對應於該特定優惠的面額類型。每個最高價值的優惠都會有自己的紀錄。 | Offer |
denominations | number range | 此欄位對應於該特定優惠的面額。 可變面額優惠 - 我們會提供兩個數值作為面額範圍。第一個為下限，第二個為上限。下單時你可以傳入該範圍內的任何數值。 固定面額優惠 - 我們會列出該優惠的所有面額。請注意，若某商家的不同固定面額有不同回饋率，每一個都會是獨立的優惠。在各自的優惠中，我們會列出該特定回饋率下的面額。 | Offer |
card_format | URL or code | 有些商家僅允許以代管 URL 方式傳遞禮品卡。在此情況下，我們會告知你可預期的格式。 | Offer |
barcode_type | 128, UPC, QR, None | 有些零售商需要條碼或 QR 碼，且其中部分需對禮品卡代碼進行處理以產生條碼號碼，例如加入前綴、刪除部分數字或加入 PIN。為了替客戶消除這些複雜性，我們會在 Issue 回應資料中回傳條碼資訊。 | Offer |
currency | Text | 禮品卡面額所對應的貨幣。 | Offer |
countries | Country list | 指出禮品卡可在哪些國家兌換。 請注意，每張禮品卡的基礎價值將綁定於禮品卡上列示的貨幣。即使可在其他通常使用不同貨幣的國家使用，其價值仍以列示的貨幣計價。 | Offer |
gift_card_expiration_window | Number | 禮品卡的有效期（月數）。係以自卡片發行起算的月份數為準。若為 null，表示該禮品卡不會到期。 | Offer |
merchant_terms | Text | 商家針對其禮品卡計畫所提供的使用條款。 | Offer |