Mode A：离线点卡导入

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

优势

不需要 API 开发
流程直观、易于理解
上线快

限制

需要人工投递点卡 CSV 文件
库存需要定期补充

集成流程

Mode A 离线点卡导入流程：供应商提供 CSV、Waffo 导入库存、用户下单支付、点卡发送到用户邮箱

点卡 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 示例：

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 后，会给供应商一条购买链接，供应商把它埋在自己的网站上。链接格式：

https://{supplier}.waffoplay.com/{site_code}/

示例：

<!-- 普通链接 -->
<a href="https://supplier.waffoplay.com/jp/">Buy Points</a>

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

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

结算与报表

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

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

下一步

Mode B：点卡获取 API

想改为实时获取点卡、不再人工投递文件，看 Mode B。

集成总览

三种模式的完整对比与接入准备清单。

⌘I

快速开始

核心概念

集成

Webhook

SDK

工具与参考

点卡充值 API

优势

限制

集成流程

点卡 CSV 格式

购买链接埋点

结算与报表

下一步

Mode B：点卡获取 API

集成总览

优势

限制

​集成流程

​点卡 CSV 格式

​购买链接埋点

​结算与报表

​下一步

Mode B：点卡获取 API

集成总览

集成流程

点卡 CSV 格式

购买链接埋点

结算与报表

下一步