ポイントアプリ（仮）

概要

購入金額に応じてポイントを付与し、チェックアウトで値引きとして利用できるロイヤルティアプリです。

インストール直後はプログラムがオフです。設定を保存したうえで「プログラムを稼働」をオンにすると、付与・利用が始まります。

できること

はじめかた

1. Shopify 管理画面からアプリをインストールします。
2. 設定 → 基本設定で、還元率・ポイント価値・付与タイミング・有効期限・入会特典などを保存します。
3. 設定ハブで「プログラムを稼働」をオンにします（このときポイント用ディスカウントが用意されます）。
4. 設定 → ストアフロント表示で、テーマのアプリ埋め込み「ポイントメニュー（右下）」をオンにして保存します。必要に応じてカートへ「ポイント利用」ブロックも追加します。
5. ログイン済みのテスト顧客でカートにポイントを適用し、チェックアウトで値引きを確認します。
6. テスト注文を発送済みにし、顧客詳細でポイント付与を確認します。
7. 必要に応じてキャンペーン（スタンダード以上）、CSV 一括、Flow / POS（プロ）を設定します。

ポイントの貯まり方

注文作成時に付与予定を予約し、発送完了をきっかけに実際の付与が行われます。還元は原則として商品小計の税込金額を税抜に換算したうえで計算し、送料は含みません。

• 注文作成: 付与予定を予約。あわせて利用ポイントがあれば残高から確定します。
• 発送完了: 予約どおり付与（猶予日数が 0 ならすぐ、1 日以上なら後日付与）。部分発送だけでは付与されず、全品発送完了で一括付与します。
• 支払い完了: 「入金完了まで付与を保留」がオンのとき、支払い確認後に付与できるようにします。
• 会員作成: 入会特典ポイントを付与します。
• キャンセル: 付与の取消と、利用ポイントの返還を行います。
• 返金: 付与・利用とも金額比率で按分して取り消す／戻します。
• 注文編集: まだ付与していない付与予定のみ、現行金額で再計算します。

ポイントの使い方

1. お客様がストアフロント（右下メニューまたはカートブロック）で利用ポイントを入力・適用します。
2. アプリが利用予約を行い、顧客メタフィールドを更新します（この時点では残高は減りません）。
3. チェックアウトで Shopify Functions のディスカウントとして値引きが適用されます（小計を超えないよう調整されます）。
4. 注文作成時に残高から確定減算され、履歴に記録されます。
5. 利用を取り消すと予約がクリアされます。カート放棄用の専用 Webhook はないため、未確定の予約はおおよそ 24 時間で自動解除されます。管理画面から手動解除もできます。

主な設定

プログラムの稼働

全体のマスタースイッチ。オフのあいだは新規の付与・利用・入会特典は動きません。

想定する消費税率

税込金額を税抜に換算するときに使う税率です（例: 10%）。

還元率（税抜ベース）

税抜金額に対する付与率です。例: 1% なら、税込 ¥1,100（税率 10%）の商品で約 10 ポイント。

ポイント価値（換算）

利用時に「何ポイントで何円引き」にするかの換算です。

最小利用単位

一度に使えるポイントの刻みです。

発送完了後の猶予日数

発送から何日後に付与するか。0 なら発送後すぐです。

入金完了まで付与を保留

後払いなどで未払いのまま発送された場合、支払い確認後まで付与しません。

付与からの有効日数

0 は無期限。それ以外は指定日数で失効します。

期限の管理方法

付与単位ごと／最終購入日で全体更新／最終付与日で全体更新、から選べます。

入会特典ポイント

プログラム参加時のボーナスポイントと、その期限・履歴表示名を設定します。

定期購入の初回でも利用可

サブスク商品を含むカートでもポイント値引きを許可します（付与ルールとは別です）。

ゲスト購入にも対応

ログインなしの注文も、メール等で顧客に紐づけて付与対象にします。

キャンセル時の戻し方

新規付与として戻す（基本設定の期限を適用）か、利用前のロットへ戻す（元の期限。期限切れ分は戻さない）かを選べます。

他ディスカウントとの併用

商品・注文・配送割引とポイント値引きを同時に使えるか。相手側のディスカウント設定も併用可能である必要があります。

プラン

Free / Standard（月額 $24.99）/ Pro（月額 $79.99）の 3 プランです。月ごとの対象注文数に上限があり、超過分は従量課金オプションで処理を継続できます。従量をオフにしている場合、枠を超えるとその月の新規ポイント処理が止まります。

• Free: 基本の付与・利用・履歴・期限・入会・ストアフロント（月 10 注文）
• Standard: 上記に加えキャンペーン・CSV 一括（月 1,000 注文）
• Pro: 上記に加え POS / Flow（月 3,000 注文）

注意事項

• プログラムがオフのままでは付与も利用も始まりません。
• 付与の本トリガーは発送完了です。未発送や部分発送のみでは貯まりません。分割発送の按分付与には未対応です。
• 還元は日本円（JPY）前提です。日本円以外の注文では付与・利用しません。
• 付与済み注文の編集による追加／取消付与には未対応です（未付与の予定のみ再計算）。
• 定期購入の「初回利用可」は値引き側の設定です。付与は通常どおり行われます。
• カート上の利用予約は、未確定のまま放置すると約 24 時間で自動解除されます。
• スマレジ連携はスイッチだけでは動きません。Shopify Flow の設定が別途必要です。
• Customer Account 専用拡張や Shopify POS ネイティブ拡張は、現状ありません（店舗連携は Flow 経由）。