> ## Documentation Index
> Fetch the complete documentation index at: https://waffo.com/docs/llms.txt
> Use this file to discover all available pages before exploring further.

# Mode A：离线点卡导入

> 供应商以 Excel/CSV 离线提供点卡，Waffo Point Topup 导入库存并代为销售发货。无需任何 API 开发。

Mode A 面向没有 API 能力的供应商。你以 Excel/CSV 文件离线把点卡交给 Waffo Point Topup，Waffo Point Topup 导入库存系统，之后由 Waffo 侧完成店面、支付与发货。

<CardGroup cols={2}>
  <Card title="优势" icon="circle-check">
    * 不需要 API 开发
    * 流程直观、易于理解
    * 上线快
  </Card>

  <Card title="限制" icon="triangle-alert">
    * 需要人工投递点卡 CSV 文件
    * 库存需要定期补充
  </Card>
</CardGroup>

## 集成流程

<Frame>
  <img src="https://mintcdn.com/waffo-docs/hUiobY-hbNbq3QYe/images/developer-docs/point-topup/mode-a-flow.png?fit=max&auto=format&n=hUiobY-hbNbq3QYe&q=85&s=532907ba095dd19dd9c32a15feb427d7" alt="Mode A 离线点卡导入流程：供应商提供 CSV、Waffo 导入库存、用户下单支付、点卡发送到用户邮箱" width="2617" height="2360" data-path="images/developer-docs/point-topup/mode-a-flow.png" />
</Frame>

## 点卡 CSV 格式

供应商需按以下 Excel/CSV 格式提供点卡：

| 序号 | 字段名          | 说明                            | 必填 | 示例                    |
| -- | ------------ | ----------------------------- | -- | --------------------- |
| 1  | `skuId`      | SKU 标识，由 Waffo Point Topup 提供 | 必填 | `SUPPLIER_POINT_001`  |
| 2  | `pointCode`  | 点卡序列号 / 卡密                    | 必填 | `ABCD-1234-EFGH-5678` |
| 3  | `faceValue`  | 面额                            | 必填 | `1000`                |
| 4  | `amount`     | 点卡售价                          | 必填 | `1000`                |
| 5  | `currency`   | 币种代码                          | 必填 | `JPY`                 |
| 6  | `expiryDate` | 有效期，如适用                       | 选填 | `2026-12-31`          |
| 7  | `batchNo`    | 批次号，用于追踪                      | 选填 | `BATCH_20250105_001`  |

CSV 示例：

```csv theme={null}
skuId,pointCode,faceValue,amount,currency,expiryDate,batchNo
SUPPLIER_POINT_001,ABCD-1234-EFGH-5678,1000,1000,JPY,2026-12-31,BATCH_20250105_001
SUPPLIER_POINT_001,EFGH-5678-IJKL-9012,1000,1000,JPY,2026-12-31,BATCH_20250105_001
SUPPLIER_POINT_002,MNOP-3456-QRST-7890,3000,2900,JPY,2026-12-31,BATCH_20250105_001
```

## 购买链接埋点

Waffo Point Topup 导入点卡 CSV 后，会给供应商一条购买链接，供应商把它埋在自己的网站上。

链接格式：

```text theme={null}
https://{supplier}.waffoplay.com/{site_code}/
```

示例：

```html theme={null}
<!-- 普通链接 -->
<a href="https://supplier.waffoplay.com/jp/">Buy Points</a>

<!-- 按钮样式 -->
<button onclick="window.location.href='https://supplier.waffoplay.com/jp/'">
    Purchase Credits
</button>
```

<Note>
  Mode A 不需要签名，也不需要 API 集成。用户点击后直接进入 Waffo Point Topup 的支付页面。
</Note>

## 结算与报表

Waffo Point Topup 提供定期结算报表，内容包括：

* 销售总点数与总金额
* 按 SKU 的收入拆分
* 剩余库存状况
* 结算金额

## 下一步

<CardGroup cols={2}>
  <Card title="Mode B：点卡获取 API" icon="package-search" href="/docs/zh/developer-docs/point-topup/mode-b-point-code-api">
    想改为实时获取点卡、不再人工投递文件，看 Mode B。
  </Card>

  <Card title="集成总览" icon="map" href="/docs/zh/developer-docs/point-topup/overview">
    三种模式的完整对比与接入准备清单。
  </Card>
</CardGroup>