---
title: 인보이스 및 원장
description: NexCMP에서 자금이 기록되는 위치 — 지갑 원장, 인보이스, 충전 결제, 환불 및 지급, 바우처, 매출 보고서.
url: https://nexcmp.com/ko/docs/billing/invoices-and-ledger/
applies_to: NexCMP 1.6.1
updated: 2026-11-02
---

# 인보이스 및 원장 {#invoices-and-ledger}

> **관리자 위치:** Finance › Billing (`/billing`) (Overview, Transactions (`/billing/ledger`), Invoices (`/billing/invoices`), Top-ups (`/billing/deposits`), Payouts (`/billing/payouts`), Vouchers (`/billing/vouchers`), Reports (`/billing/reports`) 탭 포함). **포털 위치:** Billing (`/billing`).

## 작동 내용 {#what-it-does}

NexCMP의 모든 금액은 USD 센트로 저장되며 한 번 기록됩니다. 핵심 개념: **지갑 원장**이 잔액의 단일 진실 공급원이며 인보이스, 충전 결제 및 보고서는 이를 바탕으로 생성되는 뷰입니다. 원장은 **추가 전용(append-only)**입니다. 실수는 역분개 항목을 추가하여 수정하며, 기록을 직접 편집하지 않습니다.

## 요구 사항 {#requirements}

| 항목 | 요구 사항 |
|---|---|
| 역할 | 관리자. |
| 판매자 세부 정보 | **System › Settings › General**의 **Seller & invoicing** 탭 (`/settings?tab=seller`), **Seller details (printed on invoices)** 카드에서 법인명, 사업자 등록번호, 주소, 연락처 이메일 및 인보이스 번호 접두사를 설정합니다. |
| 의존성 | 들어오는 자금을 위한 [Payment channels](https://nexcmp.com/ko/docs/billing/payment-channels/). |

## 구성 요소 {#the-pieces}

| 관리자 탭 | 목록 내용 | 권장 용도 |
|---|---|---|
| **Overview** | 오늘 및 이번 달 매출, 종류별 원장 합계(예치금, 청구, 환불, 조정, 쿠폰), 상태별 인보이스, 대기 중인 환불, 바로가기, 최근 30일간 서비스별 지출 | 일일 점검 |
| **Transactions** | 지갑 원장, 변동당 한 줄 | 고객의 잔액 설명 |
| **Invoices** | 인보이스 및 모든 서비스의 모든 구매 내역을 보여주는 두 번째 뷰 **Orders** | 문서 찾기, 재발송, 결제 완료 처리 |
| **Top-ups** | 결제 게이트웨이를 통해 수취한 금액 | 결제 확인 및 환불 |
| **Payouts** | 카드 환불, 제휴사 정산, 리셀러 출금 | 출금 승인 |
| **Vouchers** | 충전 코드 | [Promotions](https://nexcmp.com/ko/docs/billing/promotions/) 참조 |
| **Reports** | 서비스별, 리셀러별 매출 | 회계 |

### 거래(원장) {#transactions-ledger}

열: 시간, 고객, **종류**, 서비스, 금액(부호 포함), VM, 참조, 주체, 메모. 필터: 종류, 서비스, 고객 ID, 사이트(리셀러가 있는 경우), 날짜 범위 및 VM 링크.

| 종류 | 의미 |
|---|---|
| `deposit` | 게이트웨이를 통한 충전 |
| `charge` | 서비스에 대해 청구된 금액(주문, 갱신, 시간제 사용 등) |
| `refund` | 지갑으로 반환된 금액 |
| `adjust` | 관리자 크레딧 또는 데비트, 그리고 충전 코드(`vch:`으로 시작하는 참조) — 개요에는 쿠폰이 별도의 행으로 표시됩니다. |

모든 행에는 `dep:stripe:<payment-id>`과 같은 참조가 있으며, 동일한 참조를 두 번 기록할 수 없으므로 중복 웹훅으로 인해 크레딧이 두 번 적립되지 않습니다. 수동 조정을 추가하려면 **Customers › List › customer › Credit / debit**을 사용합니다. 사유는 필수이며, 양수 금액은 잔액 부족으로 잠긴 VM의 잠금 해제도 시도하고, 작업은 두 단계로 확인됩니다.

![종류, 서비스, 금액 및 참조가 표시된 월렛 원장 행을 보여주는 Transactions 탭](https://nexcmp.com/ko/docs/images/billing/invoices-and-ledger-01-ledger.webp)

### 인보이스 {#invoices}

고객이 지갑에서 결제되는 항목을 구매 또는 갱신하거나 충전할 때 인보이스가 자동으로 생성됩니다. 번호는 `<prefix><YYYYMM>-<000001>` 형식(예: `NX202610-000042`)입니다. 리셀러 사이트는 자체 접두사와 일련번호를 사용합니다. 접두사를 변경해도 기존 번호는 변경되지 않습니다.

| 필드 | 값 |
|---|---|
| 종류 | 영수증, 갱신, 충전, 수동, 환불 |
| 상태 | 미결제, 결제완료, 연체, 취소됨, 환불됨 |

행에서의 작업:

| 작업 | 효과 |
|---|---|
| **View** / **Print** | 인보이스를 엽니다. 포털에서 인쇄하거나 PDF로 저장할 수도 있습니다. |
| **Mark paid**(미결제 또는 연체 상태인 경우만) | **지갑 잔액을 이동하지 않고** 결제 완료로 표시합니다. 고객이 NexCMP 외부에서 결제한 경우에 사용하세요. 사유는 필수입니다. 갱신 인보이스의 경우 잠긴 VM을 연장하고 잠금 해제합니다. |
| **Cancel**(미결제 또는 연체 상태인 경우만) | 인보이스를 취소합니다. 사유는 필수입니다. |
| **Resend** | 인보이스를 이메일로 다시 보냅니다. |

**Create manual invoice** (탭 상단의 버튼): 고객 ID, 1~50개의 라인(설명, 수량, 단가), 선택 사항인 VM ID, 선택 사항인 납부 기한(0~365일, 기본값 7), 선택 사항인 메모. 미결제 상태로 생성되며 고객은 **Billing › Invoice History**에서 확인할 수 있습니다.

서비스의 미결제 인보이스는 잔액이 충전되는 즉시 **지갑에서 자동으로 정산**되므로, 고객은 잔액만 충전하면 됩니다.


### Top-ups (payments) {#top-ups-payments}

시도당 1개 행: 시간, 고객, **게이트웨이 및 수단**, 유형(충전 또는 자동 충전), 상태(대기 중, 완료됨, 실패함, 환불됨, 분쟁 중, 취소됨), 고객 결제 금액, 수수료, 지갑 충전 금액, 게이트웨이 참조 번호 및 완료 시간. 완료된 Stripe 및 PayPal 결제에는 **Refund** 작업이 있습니다. 웹훅을 확인하려면 게이트웨이 이벤트 페이지([Payment channels](https://nexcmp.com/ko/docs/billing/payment-channels/))를 사용하세요.

### Payouts {#payouts}

세 개의 하위 탭: **Card refunds**(환불 요청 승인 또는 거부, 요청은 완료된 결제에서 생성됨), **Affiliate payouts**(수수료 인출) 및 **Reseller withdrawals**. 모든 결정은 감사 대상이 됩니다.

### Reports {#reports}

**Revenue** (30일 추이, 월별, 우수 고객), **By service** 및 **By reseller**.

![수익 KPI와 30일 추이를 보여주는 Reports 탭](https://nexcmp.com/ko/docs/images/billing/invoices-and-ledger-03-reports.webp)

## 고객 화면 {#what-the-customer-sees}

**Billing**에서 고객은 **Balance**, **Deposit**, **Redeem code**, **Settings**(자동 충전) 및 **Invoice History**, **Payment Order**, **Ledger**, **Orders**(서비스 및 유형별 필터가 포함된 단일 목록의 모든 서비스) 탭이 있는 내역을 확인할 수 있습니다. 각 인보이스에는 **View**, **Print** 및 **Save as PDF**가 있으며, 금액은 USD 기준이고 표시 통화로 선택 전환하여 볼 수 있습니다.

## 확인 {#verify}

1. 테스트 고객으로 소액을 충전합니다.
2. **Transactions**에는 `deposit` 라인이 표시되고, **Top-ups**에는 결제 상태가 *Completed*로 표시되며, **Overview**의 수익이 증가합니다.
3. 서비스를 구매하면 `charge` 라인이 나타나고 **Invoices**에 설정한 판매자 세부 정보가 포함된 *Receipt* 또는 *Renewal* 인보이스가 표시됩니다.

## 한도 및 참고 사항 {#limits-notes}

- **추가 전용.** 원장 라인은 수정하거나 삭제할 수 없으며, 사유를 기재하여 조정 항목을 추가해야 합니다.
- **통화.** 금액은 USD이며, 표시 통화는 보기 위한 용도일 뿐입니다([Currency and exchange rates](https://nexcmp.com/ko/docs/catalog/currency-and-exchange-rates/) 참조).
- **카드로 환불**은 2단계(요청 후 Payouts에서 승인)로 진행되며, USDT 및 은행 송금은 원 출금처로 환불되지 않습니다.
- 입력한 사유와 함께 System › Logs › Admin actions에서 **모든 내역이 감사**됩니다.
- **주문 대 인보이스.** 시간당 사용량은 시간별로 청구되지 않으며, Orders 뷰에서는 여전히 확인할 수 있도록 일별로 그룹화합니다.

## Troubleshooting {#troubleshooting}

| 증상 | 원인 | 해결 방법 |
|---|---|---|
| 고객 잔액이 올바르지 않은 경우 | 예상치 못한 청구, 조정 또는 바우처 | **Transactions**을 고객 ID로 필터링하고 참조 번호와 메모를 확인합니다. |
| "인보이스가 이미 결제되었습니다" (409) | 이미 결제된 인보이스에 결제 완료 표시 | 조치할 필요가 없습니다. |
| 인보이스를 취소할 수 없음 | 미결제 또는 연체된 인보이스만 취소 가능 | 결제된 인보이스의 경우 환불 또는 조정을 사용하세요. |
| 인보이스에 판매자 정보가 누락됨 | 입력되지 않음 | System › Settings › General › Seller & invoicing에서 **Seller details**를 완료하세요. |
| 신용/직불카드 거부됨 | 금액이 0이거나 $100,000를 초과함 | 1센트에서 $100,000 사이의 금액을 사용하세요. |
| 결제 상태가 오랜 시간 *Pending*으로 표시됨 | 웹훅 누락 | **Gateway events**를 확인하고 다시 재생하세요. |