> ## Documentation Index
> Fetch the complete documentation index at: https://docs.agencyhandy.com/llms.txt
> Use this file to discover all available pages before exploring further.

# AgencyHandy에서 크레딧 설정하는 방법

> 선불 크레딧 시스템으로 서비스를 제공하세요: 패키지를 만들고, 환산율을 설정하고, 클라이언트가 서비스와 청구서에 크레딧을 구매·사용할 수 있게 합니다.

크레딧을 사용하면 선불 시스템으로 서비스를 제공할 수 있습니다. 가격이 책정된 크레딧 패키지를 만들고, 화폐 1단위로 구매할 수 있는 크레딧 수를 정의하는 환산율을 설정하면 클라이언트가 미리 크레딧을 구매합니다. 클라이언트가 서비스를 주문하거나 청구서를 지불하면 AgencyHandy가 가격을 크레딧으로 변환하고 필요한 금액을 차감하며 모든 거래를 완전한 감사 추적에 기록합니다.

## 크레딧 작동 방식

크레딧 시스템에는 세 가지 구성 요소가 있습니다:

* **크레딧 패키지**: 클라이언트가 구매하는 크레딧 묶음 (예: \$50에 500크레딧).
* **환산율**: 서비스의 통화 가격을 크레딧으로 변환하는 규칙 (예: 1 USD = 10크레딧).
* **크레딧 잔액**: 클라이언트가 서비스나 청구서에 사용할 수 있는 가용 크레딧.

**예시:** 서비스 비용이 \$3.51이고 환산율이 1 USD = 10크레딧인 경우.

`$3.51 × 10 = 35.1크레딧 → 36크레딧으로 올림`

AgencyHandy는 항상 가장 가까운 정수 크레딧으로 올림합니다.

## 크레딧 결제 활성화

클라이언트가 크레딧을 구매하거나 사용하려면 먼저 기능을 활성화해야 합니다.

<Steps>
  <Step title="크레딧으로 이동">
    왼쪽 사이드바에서 **크레딧**으로 이동합니다.
  </Step>

  <Step title="토글 켜기">
    **크레딧 결제 허용** 토글을 활성화합니다.
  </Step>
</Steps>

**활성화 시** 클라이언트는 다음을 할 수 있습니다:

* 클라이언트 포털에서 크레딧 잔액 위젯 확인.
* 크레딧 페이지에 접속하여 패키지 구매.
* 크레딧 요청 제출.
* 서비스 구매 시 **크레딧으로 구매** 사용.
* 청구서에서 **크레딧으로 결제** 사용.

**비활성화 시** 크레딧 위젯과 모든 크레딧 옵션이 클라이언트 포털에서 숨겨집니다. 기존 크레딧 잔액은 유지되며 클라이언트는 다른 결제 방법을 계속 사용할 수 있습니다.

## 크레딧 패키지 만들기

크레딧 패키지는 클라이언트가 계정에 크레딧을 충전하기 위해 구매하는 것입니다.

<Steps>
  <Step title="크레딧 패키지 설정 열기">
    **크레딧 → 설정 → 크레딧 패키지**로 이동합니다.
  </Step>

  <Step title="패키지 추가">
    **+ 패키지**를 클릭합니다.
  </Step>

  <Step title="세부 정보 입력">
    패키지 이름, 포함된 크레딧 수, 통화, 가격을 입력합니다.
  </Step>

  <Step title="저장">
    **만들기**를 클릭합니다.
  </Step>
</Steps>

## 환산율 관리

환산율은 통화 가격을 기준으로 서비스에 필요한 크레딧 수를 결정합니다. 통화별로 다른 환산율을 설정할 수 있습니다.

<Steps>
  <Step title="환산율 설정 열기">
    **크레딧 → 설정 → 환산율**로 이동합니다.
  </Step>

  <Step title="환산율 추가">
    **+ 환산율 추가**를 클릭합니다.
  </Step>

  <Step title="환산율 설정">
    통화를 선택하고 해당 통화 1단위에 해당하는 크레딧 수를 입력합니다.
  </Step>

  <Step title="저장">
    **저장**을 클릭합니다.
  </Step>
</Steps>

**예시 환산율:**

| 통화  | 환산율           |
| --- | ------------- |
| USD | 1 USD = 10크레딧 |
| EUR | 1 EUR = 9크레딧  |
| GBP | 1 GBP = 12크레딧 |

<Note>
  각 통화마다 동시에 하나의 활성 환산율만 존재할 수 있습니다.
</Note>

## 자동 vs 수동 크레딧 구매

크레딧이 클라이언트 계정에 추가되는 방식은 사용된 결제 방법에 따라 다릅니다.

**자동** (승인 불필요):

* Stripe
* PayPal

결제 성공 후 즉시 크레딧이 추가됩니다.

**수동** (에이전시 승인 필요):

* 은행 이체
* 암호화폐

클라이언트가 수동 방법으로 결제하면 크레딧 요청이 생성됩니다. 크레딧이 추가되기 전에 검토하고 승인해야 합니다.

## 크레딧 요청 관리

<Steps>
  <Step title="크레딧 요청 열기">
    **청구 → 크레딧**으로 이동합니다.
  </Step>

  <Step title="보류 중인 요청 찾기">
    클라이언트 이름, 결제 금액, 요청된 크레딧 수를 확인합니다.
  </Step>

  <Step title="승인 또는 거절">
    크레딧을 추가하려면 **수락**, 거절하려면 **거부**를 클릭합니다.
  </Step>
</Steps>

**요청 상태:**

* **보류 중**: 제출되어 검토 대기 중.
* **수락됨**: 승인됨; 크레딧이 클라이언트 잔액에 추가됨.
* **거부됨**: 거절됨; 크레딧이 추가되지 않음.

## 클라이언트 크레딧 확인

<Steps>
  <Step title="클라이언트 프로필 열기">
    **클라이언트**로 이동하여 클라이언트 이름을 클릭합니다.
  </Step>

  <Step title="크레딧 탭으로 이동">
    **크레딧** 탭을 선택합니다.
  </Step>
</Steps>

크레딧 탭에는 클라이언트의 가용 잔액, 전체 거래 내역, 누적 잔액, 거래 참조가 표시됩니다.

## 크레딧 거래 이해

모든 크레딧 활동이 클라이언트의 거래 내역에 기록됩니다.

**입금**: 계정에 추가된 크레딧:

* 크레딧 패키지 구매
* 승인된 크레딧 요청

**출금**: 계정에서 차감된 크레딧:

* 크레딧으로 구매한 서비스
* 크레딧으로 지불한 청구서

각 거래에는 날짜, 유형, 참조, 크레딧 금액, 누적 잔액이 표시되어 완전한 감사 추적을 제공합니다.
