---
title: 자동 충전
description: 저장된 카드나 PayPal 계정을 통해 고객 지갑을 자동으로 충전합니다. 사용량 기반 및 고정 모드, 글로벌 한도 및 실패 처리를 지원합니다.
url: https://nexcmp.com/ko/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/ko/docs/billing/saved-payment-methods/)으로 청구하고 지갑을 충전하여, 잔액 부족으로 실행 중인 서비스가 중단되지 않도록 합니다. 백그라운드 작업이 **5분마다** 활성화된 모든 고객을 확인합니다.

## 요구 사항 {#requirements}

| 항목 | 요구 사항 |
|---|---|
| 채널 | [Stripe](https://nexcmp.com/ko/docs/billing/stripe/) 및/또는 [PayPal](https://nexcmp.com/ko/docs/billing/paypal/) 설정됨. |
| 저장된 수단 | 고객에게 저장된 카드 또는 PayPal 계정이 있음. |
| Site | 메인 사이트, 또는 Stripe/PayPal 채널이 플랫폼을 통해 수금되는 리셀러 사이트. |
| 글로벌 스위치 | **Auto top-up enabled**가 켜져 있음(기본값 켜짐). |

## 동작 방식 {#how-it-works}

고객의 **첫 Stripe 또는 PayPal 충전** 후 서버는 결제 수단을 저장하고 **By usage** 모드로 자동 충전을 켭니다(단, 고객이 직접 자동 충전을 설정한 적이 없는 경우에만 해당). 입금 화면에 별도의 체크박스는 없으며, 서버는 증거로 시간, IP 주소 및 수단을 기록합니다. 고객이 나중에 자동 충전을 끄면, 스스로 다시 켜지지 않습니다.

| 모드 | 트리거 (잔액이 다음 미만일 때...) | 청구 금액 |
|---|---|---|
| **By usage** (첫 충전 후 기본값) | 향후 24시간 동안의 서비스 운영 비용(시간당 VM 및 24시간 내에 도래하는 선불 갱신 포함), 단 **$5** 미만으로 떨어지지 않음 | 24시간 비용을 달러 단위로 올림하며, 적어도 [minimum top-up](https://nexcmp.com/ko/docs/billing/minimum-top-up/) 이상, 최대 top-up 및 일일 한도 이하 |
| **Fixed amount** | 고객 고유의 임계값 ($1 ~ $500) | 고객 고유의 금액 (최소 충전금액부터 $1,000까지, 그리고 임계값보다 큼) |

**By usage** 모드에서 실행 중인 서비스가 없으면 아무것도 청구되지 않습니다.

임계값과 비교되는 잔액은 **지갑의 실제 현금**입니다. 프로모션 코드의 서비스 크레딧은 별도로 보관되며 합산되지 않습니다([Promotions](https://nexcmp.com/ko/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)**에서 다음을 설정합니다:

   | 설정 | Default | 범위 | 의미 |
   |---|---|---|---|
   | Auto top-up enabled | On | on 또는 off | Off는 모든 백그라운드 청구를 즉시 중단합니다. |
   | 기본 자동 충전 임계값 (USD, 고정 모드 폴백) | $5.00 | $0 ~ $10,000 | 고정 모드에서 시작 임계값으로만 사용됩니다. |
   | 고객당 24시간당 최대 자동 충전 횟수 | 3 | 1 ~ 50 | 성공 및 대기 중인 시도를 계산합니다. |
   | 고객당 24시간당 자동 충전 금액 한도 (USD) | $500.00 | $0 ~ $1,000,000 | 롤링 데이 기준 자동 청구의 총합입니다. |

3. **Save Wallet & top-up**을 클릭합니다.

![글로벌 스위치 및 일일 한도가 포함된 Fees and limits 페이지의 Auto top-up 섹션](https://nexcmp.com/ko/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/ko/docs/images/billing/auto-top-up-02-portal.webp)

## 확인 {#verify}

1. 테스트 고객으로 테스트 카드([Stripe](https://nexcmp.com/ko/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 {#troubleshooting}

| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 고객이 켤 수 없음: "카드로 또는 PayPal로 한 번 충전" | 저장된 결제 수단 없음 | 먼저 카드 또는 PayPal로 한 번 충전하세요. |
| 오류 `no_card` (422) | 선택한 게이트웨이에 저장된 결제 수단이 없음 | 결제 수단이 있는 게이트웨이를 선택하거나 결제 수단을 저장하세요. |
| 금액 관련 오류 `invalid_argument` | 허용된 범위를 벗어난 고정 모드 | 임계값 $1~$500, 충전 금액은 최소 충전 금액과 $1,000 사이, 금액은 임계값보다 커야 합니다. |
| 잔액이 부족한데도 결제되지 않음 | 전역 꺼짐, By usage 모드에서 실행 중인 서비스 없음, 일일 한도 도달 또는 이전 결제 대기 중 | 스위치, 내역 및 한도를 확인하세요. |
| "N회 연속 실패 — 3회 후 자동 충전 꺼짐" | 카드가 계속 실패함 | 고객이 카드를 새 보증금으로 교체합니다. |
| 상태 *Needs your confirmation* | 은행에서 3-D Secure를 요구함 | 고객이 일반 충전을 한 번 완료합니다. |