> ## 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. # ポイントチャージ連携の概要 > サプライヤー向け Waffo Point Topup の3つの連携モード、エンドポイントの提供元、およびモード別の準備チェックリスト。 **Waffo Point Topup** は、Waffo が提供するポイントカードチャージ API およびホワイトラベル型ポイントカードチャージソリューションです。**サプライヤー**は自社のポイントコード在庫やチャージ機能を接続するだけで、エンドユーザー向けの販売側は Waffo Point Topup が代行します。専用サブドメイン上の多言語ストアフロント、グローバル決済手段、販売における正式な販売業者（merchant-of-record）としての機能、および定期的な精算が含まれます。 本ドキュメント群はサプライヤー向けの技術連携を扱います。製品視点の紹介は[ポイントチャージ](/docs/ja/essentials/point-topup)を参照してください。 ## 用語定義 | 用語 | 説明 | | --------------------------- | --------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------------- | | **Waffo Point Topup** | Waffo が提供するポイントカードチャージ API およびホワイトラベル型ポイントカードチャージソリューション。URL リダイレクトによる統合を簡素化し、多言語対応サイトでグローバル決済手段を提供します。ポイント販売における正式な販売業者として機能し、各サプライヤー統合向けに専用サブドメインを提供します：`https://{supplier}.waffoplay.com/{site_code}/` | | **Supplier**（サプライヤー） | Waffo Point Topup にポイントコードまたは即時履行サービスを提供する上流サービスプロバイダー（例：ゲームパブリッシャー、ポイントコード発行者） | | **Distributor**（ディストリビューター） | この文脈において、Waffo Point Topup はサプライヤーの公式販売代理店として機能します | | **End User**（エンドユーザー） | Waffo Point Topup プラットフォーム上でポイントコードまたはチャージサービスを購入する消費者 | ## 3つの連携モード | モード | 名称 | 説明 | API の要否 | 最適な用途 | | ----- | ----------------- | -------------------------------------------------------- | --------------- | ------------------------------ | | **A** | オフラインポイントコードインポート | サプライヤーがオフラインでポイントコードを提供し、Waffo Point Topup が在庫にインポートする | API 不要 | API 連携なしで素早く開始する | | **B** | ポイントコード取得 API | Waffo Point Topup がサプライヤーの API を呼び出し、ポイントコードをリアルタイムで取得する | サプライヤーが API を提供 | サプライヤーによるポイントコードのセキュリティと有効期限管理 | | **C** | 即時履行 API | Waffo Point Topup がサプライヤーの API を呼び出し、ユーザーのアカウントを直接チャージする | サプライヤーが API を提供 | ユーザー体験（コンバージョン率）重視、直接チャージ | サプライヤーのシステム構成に応じて Waffo Point Topup の連携モードを選ぶ判断チャート これら3つの連携モードが実際にどのように機能するかは、デモサイトでエンドツーエンドの連携フローを確認できます。 ### 連携モード比較 | 項目 | モード A（オフライン） | モード B（ポイントコード API） | モード C（即時履行） | | ---------------------- | ------------------------- | ------------------------------ | ------------------ | | API 開発 | 不要 | 必要 | 必要 | | リアルタイム履行 | はい、ユーザーのメールアドレスへ | はい、ユーザーのメールアドレスへ | はい、即時履行 | | 在庫管理 | Waffo | サプライヤー | 該当なし | | 連携方法（サプライヤーから Waffo へ） | Waffo Point Topup への静的リンク | Waffo Point Topup への静的リンク | 注文パラメータと署名付きの動的リンク | | 連携方法（Waffo からサプライヤーへ） | 該当なし | サプライヤーのポイントコード取得 API | サプライヤーの即時履行 API | | 最適用途 | API 連携なしの迅速なローンチ | サプライヤーによるポイントコードのセキュリティと有効期限管理 | ユーザー体験（コンバージョン率） | ## どちらがどのエンドポイントを提供するか Waffo が提供するのは 2 つのエンドポイントと 1 つの Webhook だけで、[API リファレンス](/docs/api-reference/ja/introduction)のポイントチャージグループに掲載しています。 サプライヤー側のエンドポイントは**すべて任意連携**です。本ドキュメントに記載する仕様はサンプルであり、すでに同等の API をお持ちの場合は、既存の API ドキュメントを Waffo Point Topup に提供すれば、Waffo がその既存インターフェースに対応します。 | エンドポイント | 提供元 | 連携要否 | | --------------------------------------------------- | ------------------- | -------------- | | `GET /redirect` 署名リダイレクト | Waffo | モード C では**必須** | | `POST /api/v1/gamepin/fulfillment-inquiry` 即時履行結果照会 | Waffo | 任意 | | `FULFILLMENT_RESULT_NOTIFY` 履行結果通知 Webhook | Waffo が送信、サプライヤーが受信 | 任意 | | ポイントコード取得 | サプライヤー | 任意連携（サンプル仕様） | | 即時履行 | サプライヤー | 任意連携（サンプル仕様） | | 即時履行結果照会 | サプライヤー | 任意連携（サンプル仕様） | モード C の最小構成は「`GET /redirect` 署名リダイレクト + 履行結果通知 Webhook」で、履行 API を実装しない形です。この場合 Webhook が返すのは `PAY_SUCCESS` と `PAYMENT_FAILED` のみで、`PAY_SUCCESS` を受け取った後にサプライヤー側で発送処理を行います。 ## モード別の準備 サプライヤーから必要な資料： | No. | 資料 | 内容 | 備考 | | --- | -------------- | ------------ | --------------------------- | | 1 | ポイントコードデータファイル | Excel/CSV 形式 | Waffo Point Topup テンプレートに従う | | 2 | SKU 情報 | 商品タイプ、額面、通貨 | Waffo Point Topup と確認 | | 3 | 精算情報 | 銀行口座、精算サイクル | 精算と振込用 | 連携手順： サプライヤーがポイントコードデータをオフラインで提供（Excel/CSV）。 Waffo Point Topup がポイントコードを在庫システムにインポート。 Waffo Point Topup がサプライヤーに購入リンクを提供。 サプライヤーが自社ウェブサイトに購入リンクを埋め込み。 ユーザー購入後、Waffo Point Topup がポイントコードをユーザーのメールに送信。 Waffo Point Topup が定期的な精算レポートを提供。 詳細は[モード A：オフラインポイントコードインポート](/docs/ja/developer-docs/point-topup/mode-a-offline-import)を参照してください。 サプライヤーから必要な資料： | No. | 資料 | 内容 | 備考 | | --- | --------------- | ----------------- | ------------------------------------------------ | | 1 | RSA 公開鍵 | API 署名検証用 | 2048 ビット | | 2 | API キー | `X-API-KEY` | サプライヤーが Waffo Point Topup に提供 | | 3 | API エンドポイント URL | ポイントコード取得 API URL | 本番環境 + テスト環境 | | 4 | SKU 情報 | 商品タイプ、額面一覧 | Waffo Point Topup と確認 | | 5 | Distributor ID | `distributorId` | サプライヤーが Waffo Point Topup に割り当てた固有のディストリビューター ID | | 6 | 精算情報 | 銀行口座、精算サイクル | 精算と振込用 | 連携手順： サプライヤーと Waffo Point Topup が RSA 公開鍵を交換。 サプライヤーが API キーと API ドキュメントを提供。 ポイントコード取得 API を共同でテスト。 Waffo Point Topup が購入リンク（静的リンク）を提供。 サプライヤーが自社ウェブサイトにリンクを埋め込み。 本番環境でローンチ。 詳細は[モード B：ポイントコード取得 API](/docs/ja/developer-docs/point-topup/mode-b-point-code-api)を参照してください。 サプライヤーから必要な資料： | No. | 資料 | 内容 | 備考 | | --- | --------------- | --------------- | -------------------------- | | 1 | RSA 公開鍵 | API 署名検証用 | 2048 ビット | | 2 | `SECRET_KEY` | URL 署名用 | リダイレクトリンク署名用 | | 3 | API エンドポイント URL | 履行 API + 照会 API | 本番環境 + テスト環境 | | 4 | Supplier ID | `supplierId` | Waffo が発行するサプライヤー識別用の固有 ID | | 5 | 対応 site code 一覧 | `siteCode` | 例：`US`、`JP`、`HK` | | 6 | 精算情報 | 銀行口座、精算サイクル | 精算と振込用 | | 7 | Webhook URL | 履行結果通知エンドポイント | 履行ステータスの受信用 | 連携手順： サプライヤーと Waffo Point Topup が RSA 公開鍵を交換。 サプライヤーが `SECRET_KEY`、API キー、API ドキュメントを提供。 サプライヤーが URL 署名ロジックをバックエンドで実装。 URL 署名検証、即時履行 API、照会 API（任意）、履行結果通知 Webhook（任意）をテスト。 サプライヤーがウェブサイトに署名付きリダイレクトリンクを統合。 本番環境でローンチ。 詳細は[モード C：即時履行 API](/docs/ja/developer-docs/point-topup/mode-c-direct-fulfillment)を参照してください。 ## 次のステップ ポイントコード CSV 形式、購入リンクの設置、精算レポート。 リアルタイム取得のリクエスト・レスポンス項目と冪等性の要件。 URL 署名リダイレクト、即時履行、即時履行結果照会。 メッセージ構造、RSA 署名と検証、エラーコード、鍵の生成。