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

거의 항상 무료라고 예상했던 워크플로우에 유료 기능이 포함되어 있기 때문입니다 - 화이트라벨, AML, NFC 또는 액티브 라이브니스입니다. 어떤 기능인지 찾는 방법과 재발을 막는 방법입니다.

작성: Didit 지원팀 · 2026년 9월 15일 업데이트

Short answer

열에 아홉은 무료 한도가 소진된 것이 아닙니다. 대개 워크플로우에 포함된 유료 기능 때문이며, 가장 흔한 원인은 화이트라벨($0.20), AML($0.20), NFC($0.15), 액티브 라이브니스($0.15)입니다. 충전하기 전에 먼저 워크플로우를 열어 어떤 기능이 켜져 있는지 확인하세요.

인증 요청이 "You don't have enough credits to perform this request"로 실패한다면, 조직의 잔액이 워크플로우가 실행하려는 기능의 비용을 감당하지 못하는 것입니다.

API는 세션 생성 시 같은 상황을 오류 코드 insufficient_credits로 보고합니다. 티켓을 줄이는 두 가지 설명: 워크플로에서 액티브 라이브니스 방식은 3D 플래시와 3D 액션 & 플래시로 불리며, 패시브 라이브니스만 무료입니다. 또한 데이터베이스 검증과 전화번호 검증은 실행 전에 첫 충전이 추가로 필요합니다($10 환영 크레딧은 인정되지 않음). 데이터베이스 검증을 참고하세요.

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

먼저 사용량을 보고 싶은 것이 본능이지만, 워크플로우부터 확인하세요. 무료 티어는 각각 월 500건 무료가 제공되는 다음 네 가지 기능만 포함하기 때문입니다.

  • ID 인증
  • 패시브 라이브니스
  • 얼굴 매칭 1:1
  • 기기 및 IP 분석

그 외 모든 모듈은 볼륨과 무관하게 첫 체크부터 과금됩니다. 실제로 자주 나타나는 순서대로 정리하면 다음과 같습니다.

기능가격놀라운 이유
화이트라벨 / 커스텀 브랜딩인증당 $0.20룩앤필 설정이라 "체크"처럼 느껴지지 않습니다
AML 스크리닝$0.20"무료 KYC" 템플릿에 모르는 사이 추가되는 경우가 많습니다
NFC$0.15ID 인증과 별도로 과금됩니다
액티브 라이브니스$0.15패시브에서 액티브로 전환하면 무료 티어를 벗어납니다
연령 추정$0.10무료 티어의 ID 인증에는 포함되지 않습니다
설문$0.10체크가 아니라 양식처럼 느껴집니다
전화 인증$0.03부터 + 통신사 수수료통신사 수수료는 국가별로 다릅니다
이메일 인증$0.03
주소 증빙$0.20
데이터베이스 검증국가별로 다름
비즈니스 인증(KYB)$2.00
Important

화이트라벨은 가장 흔한 원인입니다. 커스텀 브랜딩이 켜진 워크플로우는 각 모듈 가격에 더해 완료된 인증 1건당 $0.20이 청구됩니다. 무료 KYC로 설계했던 플로우도 브랜딩을 입히는 순간 유료 플로우가 됩니다. 브랜딩과 경험 커스터마이징을 참고하세요.

#해결하기

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

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

  2. Options 탭도 확인하세요

    화이트라벨은 단계 목록이 아니라 워크플로우별로 Settings → Options → Include custom style에서 켜지므로, 단계를 점검할 때 놓치기 쉽습니다.

  3. 잔액을 확인하세요

    Settings → Billing에서 현재 잔액을 볼 수 있습니다. 마이너스라면 잔액이 0 이상으로 돌아올 때까지 무료 티어 체크를 포함한 모든 과금 대상 작업이 중단됩니다.

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

    유료 기능이 필요 없다면 꺼서 다시 게시하세요. 필요하다면 충전하세요 - 최소 충전 금액은 $50입니다. 충전, 인보이스, 결제 수단을 참고하세요.

계정 잔액과 Top up balance 버튼이 있는 Didit 콘솔의 결제 페이지
  1. 크레딧을 추가하면 즉시 오류가 해소됩니다.
  2. 잔액이 잘못됐다고 판단하기 전에 충전이 실제로 반영됐는지 확인하세요.
잔액을 확인하되, 먼저 워크플로우의 유료 기능부터 확인하세요.

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

  • 잔액이 마이너스인 경우. 잔액이 0 미만이 되면 무료 티어 체크도 중단됩니다. 이 경우는 정말로 유료 기능과 무관한 오류입니다.

  • 잘못된 애플리케이션의 키. 잔액은 조직 단위이지만, 확인한 워크플로우와 다른 애플리케이션의 키로 호출하고 있다면 잘못된 설정을 보고 있는 것입니다. 조직, 애플리케이션, 환경을 참고하세요.

  • 워크플로우 세션이 아니라 단독 API 호출. 단독 호출은 워크플로우 안에서는 무료인 기능이라도 무료 한도 없이 호출당 과금됩니다.

  • 해당 월의 500건을 실제로 다 쓴 경우. 이렇게 단정하기 전에 Analytics에서 그 달의 기능별 볼륨을 확인하세요. 네 기능 각각 독립된 한도를 가지므로 볼륨이 낮을 때는 가능성이 가장 낮은 원인입니다.

  • 충전 전의 전화번호 검증 또는 데이터베이스 검증. 둘 다 조직이 첫 실제 충전을 할 때까지 비활성 상태이며, 환영 크레딧으로는 해제되지 않습니다. 충전, 청구서 및 결제 수단을 참고하세요.

  • 샌드박스는 됐는데 실서비스 애플리케이션은 안 되는 경우. 샌드박스는 아무것도 과금하지 않으므로 유료 기능을 드러낼 수 없습니다. 워크플로의 실제 가격이 나타나는 곳은 첫 실서비스 세션입니다.

#재발 막기

  • Settings → Billing에서 자동 충전을 켜서 지정한 임계값 아래로 떨어지면 자동으로 잔액이 채워지게 하세요.
  • sandbox에서 테스트하세요. 여기서는 아무것도 과금되지 않고 잔액 확인도 완전히 건너뜁니다. sandbox에서 테스트하기를 참고하세요.
  • 테스트용과 라이브용 애플리케이션을 분리하세요. 그래야 실험이 프로덕션 트래픽이 의존하는 잔액을 소진시킬 수 없습니다.

#지출 상한 설정하기

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

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

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

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

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