モード A：オフラインポイントコードインポート

モード A は API 機能を持たないサプライヤー向けに設計されています。サプライヤーはポイントコードを Excel/CSV ファイルで Waffo Point Topup にオフライン提供し、Waffo Point Topup がそれらを在庫システムにインポートします。ストアフロント、決済、発送はすべて Waffo 側で完結します。

メリット

API 開発が不要
シンプルで分かりやすい
すぐに始められる

制約

手動でのポイントコード CSV ファイルの送信が必要
在庫は定期的な補充が必要

連携フロー

モード A のオフラインポイントコードインポートのフロー：サプライヤーが CSV を提供、Waffo が在庫にインポート、ユーザーが決済、ポイントコードをメールで送信

ポイントコード CSV 形式

サプライヤーは、以下の Excel/CSV 形式でポイントコードを提供する必要があります。

No.	フィールド名	説明	必須	例
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>

モード A では署名や API 統合は不要です。ユーザーは直接 Waffo Point Topup の決済ページにリダイレクトされます。

精算とレポート

Waffo Point Topup は定期的な精算レポートを提供します。内容は以下の通りです。

販売総ポイント数と金額
SKU 別の収益内訳
残在庫状況
精算決済金額

次のステップ

モード B：ポイントコード取得 API

リアルタイム取得に切り替えてファイルの手動送信をやめる場合は、モード B を参照してください。

連携の概要

3つのモードの詳細比較と準備チェックリスト。

⌘I

はじめに

コアコンセプト

インテグレーション

Webhook

SDK

ツールとリファレンス

ポイントチャージ API

モード A：オフラインポイントコードインポート

メリット

制約

連携フロー

ポイントコード CSV 形式

購入リンクの設置

精算とレポート

次のステップ

モード B：ポイントコード取得 API

連携の概要

メリット

制約

​連携フロー

​ポイントコード CSV 形式

​購入リンクの設置

​精算とレポート

​次のステップ

モード B：ポイントコード取得 API

連携の概要

連携フロー

ポイントコード CSV 形式

購入リンクの設置

精算とレポート

次のステップ