자동 충전
어드민 위치: 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 계정이 있음. |
| Site | 메인 사이트, 또는 Stripe/PayPal 채널이 플랫폼을 통해 수금되는 리셀러 사이트. |
| 글로벌 스위치 | Auto top-up enabled가 켜져 있음(기본값 켜짐). |
동작 방식
고객의 첫 Stripe 또는 PayPal 충전 후 서버는 결제 수단을 저장하고 By usage 모드로 자동 충전을 켭니다(단, 고객이 직접 자동 충전을 설정한 적이 없는 경우에만 해당). 입금 화면에 별도의 체크박스는 없으며, 서버는 증거로 시간, IP 주소 및 수단을 기록합니다. 고객이 나중에 자동 충전을 끄면, 스스로 다시 켜지지 않습니다.
| 모드 | 트리거 (잔액이 다음 미만일 때...) | 청구 금액 |
|---|---|---|
| By usage (첫 충전 후 기본값) | 향후 24시간 동안의 서비스 운영 비용(시간당 VM 및 24시간 내에 도래하는 선불 갱신 포함), 단 $5 미만으로 떨어지지 않음 | 24시간 비용을 달러 단위로 올림하며, 적어도 minimum top-up 이상, 최대 top-up 및 일일 한도 이하 |
| 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)**에서 다음을 설정합니다:
설정 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 롤링 데이 기준 자동 청구의 총합입니다. 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).
Troubleshooting
| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 고객이 켤 수 없음: "카드로 또는 PayPal로 한 번 충전" | 저장된 결제 수단 없음 | 먼저 카드 또는 PayPal로 한 번 충전하세요. |
오류 no_card (422) | 선택한 게이트웨이에 저장된 결제 수단이 없음 | 결제 수단이 있는 게이트웨이를 선택하거나 결제 수단을 저장하세요. |
금액 관련 오류 invalid_argument | 허용된 범위를 벗어난 고정 모드 | 임계값 $1~$500, 충전 금액은 최소 충전 금액과 $1,000 사이, 금액은 임계값보다 커야 합니다. |
| 잔액이 부족한데도 결제되지 않음 | 전역 꺼짐, By usage 모드에서 실행 중인 서비스 없음, 일일 한도 도달 또는 이전 결제 대기 중 | 스위치, 내역 및 한도를 확인하세요. |
| "N회 연속 실패 — 3회 후 자동 충전 꺼짐" | 카드가 계속 실패함 | 고객이 카드를 새 보증금으로 교체합니다. |
| 상태 Needs your confirmation | 은행에서 3-D Secure를 요구함 | 고객이 일반 충전을 한 번 완료합니다. |