> ## 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 离线卡密导入
> 说明 Waffo Point Topup 的 Mode A 离线点卡导入：适用场景、接入流程与准备材料、点卡 CSV 字段、购买链接的嵌入方式、补货与结算报表。
本页说明 Mode A（离线点卡导入）怎么运作：你线下提供点卡文件，Waffo Point Topup 导入库存，店面、支付和交付都由 Waffo 一侧完成。三种模式的选择见[供应商接入总览](https://waffo.com/docs/zh/support/point-topup-supplier-integration-overview-faq.md)。
## 我没有 API 能力，能接入吗？
可以，这正是 Mode A 的适用场景。你只需要按 Waffo 的模板，以 Excel/CSV 文件的形式把点卡交给 Waffo Point Topup，不需要任何 API 开发，也不需要签名。
| 优点 | 限制 |
| - | - |
| 无需开发 API | 需要人工交付点卡 CSV 文件 |
| 简单直接 | 库存需要定期补货 |
| 上手快 | |
## 接入流程是怎样的？
| 步骤 | 内容 |
| - | - |
| 1 | 你线下以 Excel/CSV 提供点卡数据 |
| 2 | Waffo Point Topup 把点卡导入库存系统 |
| 3 | Waffo Point Topup 把购买链接提供给你 |
| 4 | 你把购买链接嵌入自己的网站 |
| 5 | 用户购买后，Waffo Point Topup 把点卡发送到用户邮箱 |
| 6 | Waffo Point Topup 定期提供结算报表 |
## 接入前要准备什么？
| 材料 | 说明 |
| - | - |
| 点卡数据文件 | Excel/CSV 格式，按 Waffo Point Topup 的模板 |
| SKU 信息 | 商品类型、面额、币种，需与 Waffo Point Topup 确认 |
| 结算信息 | 银行账户、结算周期 |
## 点卡 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` |
示例文件：
```
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
```
注意：`skuId` 不是你自己定的，由 Waffo Point Topup 提供，请先与 Waffo 确认 SKU 信息。
## 购买链接怎么嵌入我的网站？
Waffo Point Topup 导入点卡文件后，会把购买链接交给你。链接格式：
```
https://{supplier}.waffoplay.com/{site_code}/
```
`{supplier}` 是 Waffo 分配给你的子域名，`{site_code}` 是站点代码（例如 `jp`）。嵌入方式就是普通的链接或按钮：
```html theme={null}
Buy Points
```
Mode A 不需要签名，也不需要 API 集成，用户会直接跳转到 Waffo Point Topup 的页面。
## 用户买完之后怎么拿到点卡？
用户付款后，Waffo Point Topup 把点卡发送到用户在店面页填写的邮箱。（用户填错邮箱等收不到点卡的情况，店面页提供了客服链接和邮箱。）
## 库存用完了怎么办？
Mode A 的库存由 Waffo Point Topup 管理，但点卡来自你提供的文件，所以需要你定期补货：按上面的格式准备新的点卡文件交给 Waffo 导入。想去掉人工交付文件这一步，可以改用 Mode B，让 Waffo 在用户付款后实时向你的接口获取点卡。
## 结算报表里有什么？
Waffo Point Topup 定期提供结算报表，内容包括：
* 销售总点数与总金额
* 按 SKU 的收入拆分
* 剩余库存状况
* 结算金额
## 想了解更多？
* 官网：Mode A：离线点卡导入 ([https://waffo.com/docs/zh/developer-docs/point-topup/mode-a-offline-import.md](https://waffo.com/docs/zh/developer-docs/point-topup/mode-a-offline-import.md))
This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.