自動トップアップ
管理画面での場所: Finance › Payment channels › Fees & limits（
/payments/fees）、カード Wallet & top-up (Billing › Policy)、セクション Auto top-up (Stripe / PayPal)。ポータルでの場所: Billing › Settings（/billing?settings=1）。
動作内容
顧客のウォレット残高が低下すると、NexCMPは保存された決済方法に課金してウォレットにチャージし、資金不足による稼働中サービスの停止を防ぎます。バックグラウンドジョブが、有効化されているすべての顧客を5分ごとにチェックします。
要件
| 項目 | 要件 |
|---|---|
| チャネル | StripeまたはPayPalが設定されていること。 |
| 保存された決済方法 | 顧客が保存されたカードまたはPayPalアカウントを持っていること。 |
| サイト | メインサイト、またはStripe/PayPalチャネルがプラットフォームで回収されるリセラーサイトであること。 |
| グローバルスイッチ | Auto top-up enabledがオンになっていること（デフォルトはオン）。 |
動作原理
お客様が初めてStripeまたはPayPalでチャージを行うと、サーバーは支払い方法を保存し、お客様自身で自動チャージが設定されていない場合に限り、By usageモードで自動チャージを有効にします。入金画面に追加のチェックボックスはありません。サーバーは日時、IPアドレス、決済方法を記録として保持します。お客様が後から自動チャージをオフにした場合、自動的に再びオンになることはありません。
| モード | トリガー（残高が以下の場合...） | 請求金額 |
|---|---|---|
| By usage（初回チャージ後のデフォルト） | 今後24時間のサービス稼働コスト（時間貸しVMおよび24時間以内に到来するプリペイド更新料金）、ただし**$5**を下回ることはありません | 24時間のコストを1ドル単位で切り上げた金額で、minimum top-up以上、最大チャージ額および1日の上限額以下となります |
| Fixed amount | お客様独自の設定しきい値（$1から$500） | お客様独自の金額（最小チャージ額から$1,000まで、かつしきい値より大きい金額） |
By usageモードで稼働中のサービスがない場合、課金は行われません。
しきい値と比較される残高は、ウォレット内のリアルマネーです。プロモーションコードによるサービス利用クレジットは別管理となり、計算対象外となります（Promotionsを参照）。
手数料は通常のチャージと同様に処理されます。Customer pays top-up feeが有効な場合はカードに金額と手数料が合算して請求されウォレットには全額が入金され、無効な場合はウォレットに手数料を差し引いた金額が入金されます。
グローバル制限の設定
Finance › Payment channels › Fees & limits (
/payments/fees) を開きます。**Auto top-up (Stripe / PayPal)**で以下を設定します：
設定 デフォルト 範囲 意味 Auto top-up enabled On オンまたはオフ オフにすると、すべてのバックグラウンド課金が即座に停止します。 デフォルトの自動トップアップ閾値 (USD、固定モードフォールバック) $5.00 $0 から $10,000 固定モードにおける開始時のしきい値としてのみ使用されます。 顧客ごとの24時間あたりの最大自動トップアップ回数 3 1から50 成功した試行と保留中の試行の両方がカウントされます。 顧客ごとの24時間あたりの自動トップアップ金額上限 (USD) $500.00 $0から$1,000,000 ローリング24時間における自動課金の合計金額。 Save Wallet & top-up をクリックします。
お客様の画面
- ポータルで、お客様はBillingを開き、Settingsをクリックします。
- パネルには、保存された支払い方法、オン/オフスイッチ、モード（By usageまたはFixed amount）、推定現在利用状況と次回の請求予定額、およびRecent automatic top-upsが表示されます。
- Fixed amountに切り替えると、しきい値と金額を入力できるようになります。スイッチをオフにすると課金が停止します。
確認
- テスト用のお客様として、テストカード（Stripe）で初回チャージを行います。Billing › Settings を開くと、自動チャージがオンになっています。
- VMを小規模で稼働させて利用実績を作り、残高をしきい値未満に下げます（例：Customers › customer › Credit / debitを使用）。
- 約5分以内に課金が行われます。お客様のOverview › PaymentカードにあるAuto top-up historyにステータスが Done となった試行が表示され、Top-up received 通知が送信されます。
制限と注意事項
- 1回の残高低下につき1回の課金。 課金後、残高がしきい値以上に戻るか、待機時間が終了するまでジョブは待機します。成功後は1時間、保留中の課金後は24時間、システムエラー後は30分です。
- 日次制限。 いずれかの日次制限に達した場合、課金は行われず、Daily limit reached という行が記録されます（6時間に1回まで）。
- 失敗。 カードの拒否、有効期限切れ、残高不足はカードの失敗としてカウントされます。ジョブは1時間後、6時間後、24時間後に再試行します。3回連続でカードの決済に失敗すると自動トップアップがオフになり、お客様に通知されます（Auto top-up failed）。お客様の確認が必要な支払い（3-D Secureなど）は失敗としてカウントされず、お客様に確認するよう案内されます。
- 二重課金の防止。 各課金はしきい値を下回る下落ごとにアトミックに実行され、ゲートウェイ側でべき等性キーが使用されます。
- カードの削除を行うと、自動トップアップはオフになります。
- リセラー。 リセラーが独自の決済チャネルを使用している場合、お客様は自動トップアップを有効にできません（HTTP 403
feature_disabled）。
トラブルシューティング
| 症状 | 原因 | 対処法 |
|---|---|---|
| お客様がオンにできない: 「カードまたは PayPal で1回トップアップする」 | 保存された決済手段がない | まずカードまたは PayPal で1回トップアップを行ってください。 |
エラー no_card (422) | 選択したゲートウェイに保存された決済手段がない | 決済手段を持つゲートウェイを選択するか、決済手段を保存してください。 |
金額のエラー invalid_argument | 固定モードが許容範囲外 | しきい値は $1～$500、金額は最低トップアップ額から $1,000 の間、および金額らしきい値より大きいこと。 |
| 残高が少ないにもかかわらず何も課金されない | グローバルスイッチがオフ、By usage モードで実行中のサービスがない、1日の制限に達した、または前の課金がまだ待機中である | スイッチ、履歴、制限を確認してください。 |
| 「N回連続で失敗 — 3回で自動トップアップがオフになります」 | カードの失敗が続いている | お客様がカードを新しいデポジットに置き換える。 |
| ステータス Needs your confirmation | 銀行による 3-D Secure の要求 | お客様が通常のトップアップを1回完了する。 |