商户表
| 字段名 | 约束 | 说明 | 表 |
|---|---|---|---|
merchant_name | 文本 | 这是特定礼品卡商户的名称。如果你调用的目录会在同一商户下同时显示固定面额和可变面额的优惠，每种优惠类型在每个商户上都会有唯一记录。 | Merchant |
merchant_slug | 文本 | 这是商户的缩写名称。它可用于通过 API 将购买记录传递给 Fluz 指定商户，也用于在 Fluz 网页应用上生成商户的 URL。URL 结构为 https://fluz.app/store/merchant_slug | Merchant |
updated_at | 日期、时间戳 | 对商户表中该记录的最后一次更新 | Merchant |
created_at | 日期、时间戳 | 将此商户添加到我们目录的日期 | Merchant |
merchant_status | Active 或 Inactive | 指示商户此时是否可购买。商户状态可以是 active 或 inactive。如果商户被归档，它将从目录导出中完全移除。 | Merchant |
logo_url | URL | 商户徽标图片。将是方形的商户徽标图像，300 x 300 像素的矢量图。 | Merchant |
faceplate_image | JSON | 礼品卡不同尺寸图像的 JSON 对象。这些是商户提供的礼品卡官方图片。 | Merchant |
primary_color | 十六进制色值 | 为了便于你方的商品陈列，Fluz 将向你提供商户徽标图像中的主色。 | Merchant |
type | Gift Card 或 Card Linked Offer | Fluz 既有礼品卡优惠也有卡绑定优惠，具体取决于商户。每个商户可以有任一选项。此字段将确认优惠类型是礼品卡优惠还是卡绑定优惠。 | Merchant |
category | 列表 | 这是该商户在整个 Fluz 目录中的映射。 | Merchant |
daily_limit-consumer | 数字 | 单个消费者账户在单个日历日内对单个商户可购买的美元总上限。日历日基于 UTC 时区运行，限额每日重置。 | Merchant |
daily_limit-commercial | 数字 | 单个商业账户在单个日历日内对单个商户可购买的美元总上限。日历日基于 UTC 时区运行，限额每日重置。 | Merchant |
monthly_limit-consumer | 数字 | 单个消费者账户在单个日历月内对单个商户可购买的美元总上限。日历月基于 UTC 时区运行，从月初至该月最后一天，限额每月重置。 | Merchant |
monthly_limit-commercial | 数字 | 单个商业账户在单个日历月内对单个商户可购买的美元总上限。日历月基于 UTC 时区运行，从月初至该月最后一天，限额每月重置。 | Merchant |
website_url | URL | 这是该特定商户的 URL。请注意，如果商户有多个 URL 或子域，Fluz 将为该商户提供单一 URL。 | Merchant |
redemption_information | 文本 | 关于如何在该特定商户兑换礼品卡的详细信息。这些可以是特定的 | Merchant |
parent_company | 文本 | 如果特定商户的礼品卡可用于其他零售品牌，我们将列出其母公司的名称 | Merchant |
redeemable_at_other_brands | 列表 | 此礼品卡可在哪些其他商户兑换。有时是同一母公司下的其他子商户；但也可能是多品牌卡可用的一组商户。 示例： 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 | 文本 | 如果商户有将礼品卡余额直接应用到你在该商户账户的特定 URL，则该 URL 将在此字段提供。 | Merchant |
description | 文本 | 商户的完整详细描述。 | Merchant |
short_description | 文本 | 该商户描述的简短版本。 | Merchant |
merchant_support_phone_number | 电话号码 | 如果商户提供了专门用于其礼品卡项目支持问题的电话号码，将在此提供。 | Merchant |
merchant_support_email | 电子邮箱地址 | 如果商户提供了专门用于其礼品卡项目支持问题的电子邮箱地址，将在此提供。 | Merchant |
优惠表
| 字段名 | 约束 | 说明 | 表 |
|---|---|---|---|
offer_id | UUID | 这是你将引用的公共优惠 ID | Offer |
rate | number | 这是该商户的最佳费率。 如果固定面额与可变面额费率相同，则只包含可变面额。 如果可变面额低于固定面额，请同时包含可变和固定面额优惠，除非你调用的目录仅包含可变面额优惠。 当商户有多个不同固定面额且费率不同的优惠时，每个“面额 + 费率”组合都会有单独的优惠。 | Offer |
denomination_type | Fixed 或 Variable | 此字段对应该特定优惠的面额类型。每个最高价值的优惠将有其独立记录。 | Offer |
denominations | 数值范围 | 此字段对应该特定优惠的面额。 可变面额优惠 - 我们将提供两个面额值。第一个为下限，第二个为上限。下单时你可以传递该范围内的任意数值。 固定面额优惠 - 我们将列出该优惠上的所有面额。请注意，如果某商户的不同固定面额有不同费率，则每个都会是单独的优惠；在相应优惠中，我们会列出该特定费率下的面额。 | Offer |
card_format | URL 或 code | 一些商户只允许使用托管 URL 进行礼品卡投递。在这种情况下，我们会告知你可预期的格式。 | Offer |
barcode_type | 128、UPC、QR、None | 一些零售商需要条形码或二维码，而且有些零售商要求对礼品码进行处理以生成条码号，例如添加前缀、去掉某些数字或加入 PIN。为免去客户的复杂操作，我们会在 Issue 响应数据中返回条码信息。 | Offer |
currency | 文本 | 这是礼品卡面值所绑定的货币。 | Offer |
countries | 国家列表 | 表明礼品卡可在哪些国家兑换。 请注意，每张礼品卡的基础价值将绑定在礼品卡上列示的货币。即使它可在通常使用不同货币的其他国家使用，其价值仍绑定于所列货币。 | Offer |
gift_card_expiration_window | 数字 | 礼品卡的到期月份数，基于自卡片发放起的月份数。若为 null，表示礼品卡不过期。 | Offer |
merchant_terms | 文本 | 由商户提供的该商户礼品卡项目的使用条款。 | Offer |