Mode A 离线卡密导入

本页说明 Mode A（离线点卡导入）怎么运作：你线下提供点卡文件，Waffo Point Topup 导入库存，店面、支付和交付都由 Waffo 一侧完成。三种模式的选择见供应商接入总览。

我没有 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）。嵌入方式就是普通的链接或按钮：

<!-- 普通链接 -->
<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 把点卡发送到用户在店面页填写的邮箱。（用户填错邮箱等收不到点卡的情况，店面页提供了客服链接和邮箱。）

库存用完了怎么办？

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)

产品与服务

收单与支付

结算与资金

增值服务

高级功能

点卡充值

我没有 API 能力，能接入吗？

接入流程是怎样的？

接入前要准备什么？

点卡 CSV 文件要包含哪些字段？

购买链接怎么嵌入我的网站？

用户买完之后怎么拿到点卡？

库存用完了怎么办？

结算报表里有什么？

想了解更多？

​我没有 API 能力，能接入吗？

​接入流程是怎样的？

​接入前要准备什么？

​点卡 CSV 文件要包含哪些字段？

​购买链接怎么嵌入我的网站？

​用户买完之后怎么拿到点卡？

​库存用完了怎么办？

​结算报表里有什么？

​想了解更多？

我没有 API 能力，能接入吗？

接入流程是怎样的？

接入前要准备什么？

点卡 CSV 文件要包含哪些字段？

购买链接怎么嵌入我的网站？

用户买完之后怎么拿到点卡？

库存用完了怎么办？

结算报表里有什么？

想了解更多？