---
title: 自動トップアップ
description: 保存されたカードまたは PayPal アカウントから顧客ウォレットに自動入金 — 従量課金および固定モード、グローバル制限、失敗時の処理。
url: https://nexcmp.com/ja/docs/billing/auto-top-up/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 自動トップアップ {#auto-top-up}

> **管理画面での場所:** Finance › Payment channels › Fees & limits（`/payments/fees`）、カード **Wallet & top-up (Billing › Policy)**、セクション **Auto top-up (Stripe / PayPal)**。**ポータルでの場所:** Billing › Settings（`/billing?settings=1`）。

## 動作内容 {#what-it-does}

顧客のウォレット残高が低下すると、NexCMPは[保存された決済方法](https://nexcmp.com/ja/docs/billing/saved-payment-methods/)に課金してウォレットにチャージし、資金不足による稼働中サービスの停止を防ぎます。バックグラウンドジョブが、有効化されているすべての顧客を**5分ごとに**チェックします。

## 要件 {#requirements}

| 項目 | 要件 |
|---|---|
| チャネル | [Stripe](https://nexcmp.com/ja/docs/billing/stripe/)または[PayPal](https://nexcmp.com/ja/docs/billing/paypal/)が設定されていること。 |
| 保存された決済方法 | 顧客が保存されたカードまたはPayPalアカウントを持っていること。 |
| サイト | メインサイト、またはStripe/PayPalチャネルがプラットフォームで回収されるリセラーサイトであること。 |
| グローバルスイッチ | **Auto top-up enabled**がオンになっていること（デフォルトはオン）。 |

## 動作原理 {#how-it-works}

お客様が**初めてStripeまたはPayPalでチャージ**を行うと、サーバーは支払い方法を保存し、お客様自身で自動チャージが設定されていない場合に限り、**By usage**モードで自動チャージを有効にします。入金画面に追加のチェックボックスはありません。サーバーは日時、IPアドレス、決済方法を記録として保持します。お客様が後から自動チャージをオフにした場合、自動的に再びオンになることはありません。

| モード | トリガー（残高が以下の場合...） | 請求金額 |
|---|---|---|
| **By usage**（初回チャージ後のデフォルト） | 今後24時間のサービス稼働コスト（時間貸しVMおよび24時間以内に到来するプリペイド更新料金）、ただし**$5**を下回ることはありません | 24時間のコストを1ドル単位で切り上げた金額で、[minimum top-up](https://nexcmp.com/ja/docs/billing/minimum-top-up/)以上、最大チャージ額および1日の上限額以下となります |
| **Fixed amount** | お客様独自の設定しきい値（$1から$500） | お客様独自の金額（最小チャージ額から$1,000まで、かつしきい値より大きい金額） |

**By usage**モードで稼働中のサービスがない場合、課金は行われません。

しきい値と比較される残高は、**ウォレット内のリアルマネー**です。プロモーションコードによるサービス利用クレジットは別管理となり、計算対象外となります（[Promotions](https://nexcmp.com/ja/docs/billing/promotions/)を参照）。

手数料は通常のチャージと同様に処理されます。**Customer pays top-up fee**が有効な場合はカードに金額と手数料が合算して請求されウォレットには全額が入金され、無効な場合はウォレットに手数料を差し引いた金額が入金されます。

## グローバル制限の設定 {#configure-the-global-limits}

1. **Finance › Payment channels › Fees & limits** (`/payments/fees`) を開きます。
2. **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時間における自動課金の合計金額。 |

3. **Save Wallet & top-up** をクリックします。

![グローバルスイッチと1日の制限を備えたFees and limitsページのAuto top-upセクション](https://nexcmp.com/ja/docs/images/billing/auto-top-up-01-limits.webp)

## お客様の画面 {#what-the-customer-sees}

1. ポータルで、お客様は**Billing**を開き、**Settings**をクリックします。
2. パネルには、保存された支払い方法、オン/オフスイッチ、モード（**By usage**または**Fixed amount**）、推定現在利用状況と次回の請求予定額、および**Recent automatic top-ups**が表示されます。
3. **Fixed amount**に切り替えると、しきい値と金額を入力できるようになります。スイッチをオフにすると課金が停止します。

![By usageモードの自動チャージと最近の自動チャージが表示されたお客様の請求設定](https://nexcmp.com/ja/docs/images/billing/auto-top-up-02-portal.webp)

## 確認 {#verify}

1. テスト用のお客様として、テストカード（[Stripe](https://nexcmp.com/ja/docs/billing/stripe/#verify)）で初回チャージを行います。**Billing › Settings** を開くと、自動チャージがオンになっています。
2. VMを小規模で稼働させて利用実績を作り、残高をしきい値未満に下げます（例：**Customers › customer › Credit / debit**を使用）。
3. 約5分以内に課金が行われます。お客様の**Overview › Payment**カードにある**Auto top-up history**にステータスが *Done* となった試行が表示され、*Top-up received* 通知が送信されます。

## 制限と注意事項 {#limits-notes}

- **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`）。

## トラブルシューティング {#troubleshooting}

| 症状 | 原因 | 対処法 |
|---|---|---|
| お客様がオンにできない: 「カードまたは 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回完了する。 |