# "크레딧 부족" 오류 해결하기

Source: https://help.didit.me/ko/billing-credits/not-enough-credits
Updated: 2026-10-31

요금제 크레딧과 잔액을 다 썼거나, 워크플로우에 무료 요금제 크레딧으로 결제할 수 없는 검사가 포함되어 있습니다. 원인을 찾아 재발을 막으세요.

이번 달 요금제 크레딧과 충전 잔액으로 워크플로우의 검사를 결제할 수 없는 상태입니다. 워크플로우에 **화이트라벨**($0.20), AML($0.20), NFC($0.15), 액티브 라이브니스($0.15)가 포함되어 있으면 무료 요금제의 월 $10가 예상보다 빨리 소진됩니다. 충전하기 전에 먼저 워크플로우를 열어 어떤 기능이 켜져 있는지 확인하세요.

인증 요청이 `"You don't have enough credits to perform this request"`로 실패하거나, 세션을 생성할 때 API가 오류 코드 `insufficient_credits`로 응답한다면, 조직의 잔액이 워크플로우가 실행하려는 기능의 비용을 감당하지 못하는 것입니다. 같은 원인이 **"크레딧 부족" 오류(때로는 502)** 로 나타나기도 합니다. 예를 들어 워크플로우에 전화번호 인증이나 데이터베이스 검증이 포함되어 있는데, 무료 요금제 크레딧으로는 결제되지 않는 경우입니다.

## 잔액을 확인하기 전에 워크플로우부터 확인하세요

먼저 사용량을 보고 싶은 것이 본능이지만, **워크플로우**부터 확인하세요. 활성화된 모든 모듈이 월 $10 크레딧(무료 요금제)과 그다음 잔액에서 결제되며, 일부 모듈은 기본 네 가지(ID 인증, 패시브 라이브니스, 얼굴 매칭 1:1, 기기 및 IP 분석 - 합계 $0.33)보다 훨씬 비싸기 때문입니다. 실제로 자주 나타나는 순서대로 정리하면 다음과 같습니다.

| 기능 | 가격 | 놀라운 이유 |
|---|---|---|
| **화이트라벨 / 커스텀 브랜딩** | 인증당 $0.20 | 룩앤필 설정이라 "체크"처럼 느껴지지 않습니다 |
| **AML 스크리닝** | $0.20 | 기본 KYC 템플릿에 모르는 사이 추가되는 경우가 많습니다 |
| **NFC** | $0.15 | ID 인증과 별도로 과금됩니다 |
| **액티브 라이브니스** | $0.15 | 패시브에서 액티브로 전환하면 가격이 올라갑니다. 워크플로우에서 액티브 방식은 **3D 플래시**와 **3D 액션 & 플래시**이며, **패시브 라이브니스**는 $0.10입니다 |
| **연령 추정** | $0.10 | ID 인증과 별도로 가격이 책정됩니다 |
| **설문** | $0.10 | 체크가 아니라 양식처럼 느껴집니다 |
| **전화 인증** | $0.03부터 + 통신사 수수료 | 통신사 수수료는 국가별로 다릅니다 |
| **이메일 인증** | $0.03 | |
| **주소 증빙** | $0.20 | |
| **데이터베이스 검증** | 국가별로 다름 | 실행되려면 **첫 충전**도 필요하며, 무료 요금제 크레딧은 인정되지 않습니다. [데이터베이스 검증](https://help.didit.me/ko/documents-coverage/database-validation)을 참고하세요 |
| **비즈니스 인증(KYB)** | 국가와 등록 정보 조회 등급에 따라 다름 | |

> **Warning:** **화이트라벨은 가장 흔한 원인입니다.** 커스텀 브랜딩이 켜진 워크플로우는 각 모듈 가격**에 더해** 완료된 인증 1건당 $0.20이 청구됩니다. 기본 KYC로 설계했던 플로우도 브랜딩을 입히는 순간 비용이 약 60% 늘어납니다. [브랜딩과 경험 커스터마이징](https://help.didit.me/ko/workflows/customize-branding-and-experience)을 참고하세요.

## 해결하기

1. **실패한 세션이 사용하는 워크플로우를 여세요**

   아무 워크플로우가 아니라 그 세션이 생성될 때 사용된 ID의 워크플로우입니다. **Workflows**에서 활성화된 모든 기능을 위 표와 대조해 확인하세요.

2. **숨겨진 커스텀 스타일 스위치를 찾으세요**

   화이트라벨은 **Include custom style**이라는 워크플로우별 설정이며 단계 목록에 없기 때문에, 단계를 점검해도 찾을 수 없습니다. 워크플로우 편집기에서는 **헤더의 색상 견본 아이콘 옆에 있는 작은 스위치이며, 그 아이콘에 마우스를 올려야만 나타나므로**, 아무도 기억하지 못하는 사이에 워크플로우에 브랜딩이 적용되어 있을 수 있습니다. 같은 설정은 워크플로우의 **Settings** 사이드바에도 있으며, 그곳에서는 항상 표시됩니다.

3. **잔액을 확인하세요**

   **설정 → 결제 및 요금제**에서 현재 잔액을 볼 수 있습니다. 이번 달 크레딧을 다 쓴 상태에서 잔액이 0이거나 마이너스라면, 잔액이 0 이상으로 돌아올 때까지 모든 과금 대상 작업이 중단됩니다.

4. **유료 기능을 끄거나 충전하세요**

   유료 기능이 필요 없다면 꺼서 다시 게시하세요. 필요하다면 충전하세요 - 최소 충전 금액은 $50입니다. [충전, 인보이스, 결제 수단](https://help.didit.me/ko/billing-credits/top-ups-invoices-and-payments)을 참고하세요.

![계정 잔액과 충전 버튼이 있는 Didit 콘솔의 결제 페이지](https://help.didit.me/screenshots/billing-credits-light.webp)

*잔액을 확인하되, 먼저 워크플로우의 유료 기능부터 확인하세요.*

## 함께 확인해 볼 만한 다른 원인

- **잔액이 마이너스인 경우.** 잔액이 0 미만이 되고 월 크레딧도 다 썼다면 라이브 체크가 중단됩니다. 이 경우는 정말로 특정 모듈과 무관한 오류입니다.
- **잘못된 애플리케이션의 키.** 잔액은 조직 단위이지만, 확인한 워크플로우와 다른 애플리케이션의 키로 호출하고 있다면 잘못된 설정을 보고 있는 것입니다. [조직, 애플리케이션, 환경](https://help.didit.me/ko/account-organization/organizations-and-applications)을 참고하세요.
- **워크플로우 세션이 아니라 단독 API 호출.** 단독 호출은 정가로 호출당 과금되며 같은 크레딧과 잔액을 사용하므로, 예상보다 빨리 소진될 수 있습니다.
- **충전 전의 전화번호 검증 또는 데이터베이스 검증.** 둘 다 조직이 첫 실제 충전을 할 때까지 비활성 상태이며, 무료 요금제 크레딧으로는 해제되지 않습니다. [충전, 인보이스, 결제 수단](https://help.didit.me/ko/billing-credits/top-ups-invoices-and-payments)을 참고하세요.
- **샌드박스는 됐는데 라이브 애플리케이션은 안 되는 경우.** 샌드박스는 아무것도 과금하지 않으므로 유료 기능을 드러낼 수 없습니다. 워크플로우의 실제 가격이 나타나는 곳은 첫 라이브 세션입니다.
- **이번 달 $10를 실제로 다 쓴 경우.** 이렇게 단정하기 전에 Analytics에서 그 달의 기능별 볼륨을, Usage에서 각 체크의 청구 금액을 확인하세요. 크레딧은 매월 1일에 초기화됩니다.

## 재발 막기

- **설정 → 결제 및 요금제**에서 **자동 충전**을 켜서 지정한 임계값 아래로 떨어지면 자동으로 잔액이 채워지게 하세요.
- **sandbox에서 테스트하세요.** 여기서는 아무것도 과금되지 않고 잔액 확인도 완전히 건너뜁니다. [sandbox에서 테스트하기](https://help.didit.me/ko/getting-started/sandbox-and-testing)를 참고하세요.
- **테스트용과 라이브용 애플리케이션을 분리하세요.** 그래야 실험이 프로덕션 트래픽이 의존하는 잔액을 소진시킬 수 없습니다.

## 지출 상한 설정하기

테스트 중 계정이 마이너스로 가지 않도록 확실한 상한선을 원한다면, 이는 워크플로우 설정이 아니라 계정 단위 통제 사항이므로 조직에서 사용할 수 있는 옵션을 지원팀에 문의하세요. 그동안은 sandbox 애플리케이션에서 계속 테스트하는 것이 실용적인 대안입니다. 그곳에서는 지출할 것 자체가 없습니다.

## 셀프서비스 충전이 안 되는 경우

연간 요금제 조직은 셀프서비스 충전 플로우로 크레딧을 구매할 수 없습니다. 대신 계정 관리자에게 문의하세요. 셀프서비스로 시도하면 조용히 실패하는 대신 이렇게 안내받게 됩니다.

## 잔액이 이상해 보이는 경우

잔액, 인보이스, 인증 이력이 갑자기 사라지거나 잘못된 것처럼 보인다면 거의 항상 일시적인 플랫폼 문제이지 데이터 손실이 아닙니다. 스스로 해결하려 하지 말고 지원팀에 문의하고 조직 ID를 함께 알려주세요.