# 과금과 포인트 환불

> YesCaptcha의 포인트 차감 방식이에요. 1위안 = 1,000포인트이고 작업 유형별로 차감해요. 인식 실패와 타임아웃은 자동으로 포인트가 환불되고, 오류를 반환한 요청은 차감하지 않아요. 잔액은 10포인트보다 많아야 해요. 이미지 인식 신고 후 포인트 환불은 약 24시간 뒤에 처리돼요.

Source: https://docs.yescaptcha.com/ko/getting-started/billing/ · Last verified: 2026-10-15

> This page was machine-translated from the Chinese version. If anything differs, the Chinese version prevails: https://docs.yescaptcha.com/zh/getting-started/billing/

YesCaptcha는 작업 단위로 포인트를 차감해요. 작업 유형마다 고정 가격이 있고 1위안 = 1,000포인트예요. 예를 들어 `NoCaptchaTaskProxyless`는 작업당 15 포인트 (≈ $2.25 / 1k)이에요. 유형별 가격은 [작업 유형과 가격](https://docs.yescaptcha.com/ko/tasks.md)에서 확인하세요.

> **팁:** 성공한 작업에 대해서만 비용을 내요. 인식에 실패하거나 타임아웃된 작업은 자동으로 포인트가 환불되고, 오류를 반환한 요청은 포인트를 차감하지 않아요.

## 포인트가 차감되는 시점

-   **비동기 유형**(토큰을 반환하는 작업 유형 대부분): 작업이 생성될 때 포인트를 차감해요. 이후 인식에 실패하거나(`ERROR_CAPTCHA_UNSOLVABLE` 등) 타임아웃되면(`ERROR_TASK_TIMEOUT`, 보통 110초) 포인트가 자동으로 환불돼요.
-   **동기 유형**(이미지 인식, `ImageToTextTaskOcrBase`, `ImageToTextTaskMuggle`): 인식에 성공해 결과를 반환할 때 포인트를 차감해요.
-   작업을 생성하는 시점에 오류가 반환된 경우(잘못된 파라미터, 잔액 부족, 동시 작업 수 제한 초과 등)에는 포인트를 차감하지 않아요.

## 잔액

-   작업을 생성하려면 잔액이 **10포인트보다 많아야** 해요. 그렇지 않으면 `ERROR_ZERO_BALANCE`가 반환돼요.
-   잔액은 [getBalance](https://docs.yescaptcha.com/ko/api/get-balance.md)로 조회해요. 포인트가 차감되지 않아요.
-   충전과 VIP 보너스는 [충전과 VIP](https://docs.yescaptcha.com/ko/account/recharge.md)를 참고하세요. 누적 충전액이 VIP 등급에 도달하면, 이후 충전할 때마다 비율에 따라 포인트를 보너스로 지급해요.

## 경우에 따라 가격이 달라지는 유형

-   **reCAPTCHA v2 이미지 인식**(`ReCaptchaV2Classification`): 1x1 작은 이미지와 3x3, 4x4 큰 이미지의 가격이 달라요. [reCAPTCHA v2 이미지 인식](https://docs.yescaptcha.com/ko/tasks/recaptcha-classification.md)을 참고하세요.
-   **hCaptcha 이미지 인식**(`HCaptchaClassification`): 대상을 찾지 못해 결과가 비어 있으면 포인트를 차감하지 않아요.

## 인식 오류 신고 후 포인트 환불

이미지 인식 결과가 틀렸다면 [report](https://docs.yescaptcha.com/ko/api/report.md)로 신고할 수 있어요. 조건에 맞으면 포인트가 환불돼요.

-   이미지 인식 유형 5가지만 해당돼요: `FunCaptchaClassification`, `HCaptchaClassification`, `ReCaptchaV2Classification`, `AwsClassification`, `bCaptchaClassification`.
-   작업을 생성하고 **1시간 이내**에 신고해야 하고, 같은 작업은 한 번만 계산해요.
-   바로 환불되지 않고 **약 24시간 뒤**에 일괄 정산해요.
-   정산할 때 같은 기간에 같은 질문을 푼 다른 사용자와 비교해요. 신고한 실패율이 같은 기간 수준보다 뚜렷하게 높으면 같은 기간의 실패율에 맞춰 환불해요.
-   성공과 실패를 모두 사실대로 신고해 주세요. 실패만 신고한 내역은 같은 기간의 참고 자료로 쓰지 않으며, 실패율은 생성한 전체 작업을 기준으로 계산해요.
-   정산 결과에 이의가 있으면 [고객 지원](https://docs.yescaptcha.com/ko/help/contact.md)에 문의해 이의를 제기할 수 있어요.

토큰을 반환하는 작업 유형(reCAPTCHA, hCaptcha, Turnstile 등)은 토큰이 통과되는지를 대상 사이트가 판단하므로, 신고해도 포인트가 환불되지 않아요.

## 포인트를 차감하지 않는 경우

| 상황 | 반환 |
| --- | --- |
| 잘못된 파라미터, 존재하지 않는 유형, 잘못된 `clientKey` | 해당 오류 코드 |
| 잔액이 10포인트 이하 | `ERROR_ZERO_BALANCE` |
| 동시 작업 수 제한 초과 | `ERROR_THREADS_MAXIMUM`, [동시 작업 수 제한과 자동 일시 중지](https://docs.yescaptcha.com/ko/api/rate-limits.md) 참고 |
| 자동 일시 중지 중 | `ERROR_IP_BLOCKED_5MIN` |
| 유효하지 않다고 판정된 sitekey 또는 도메인(캐시 기간 중) | 기존 오류 코드, `cached: true` 포함 |
| 인식 실패, 타임아웃 | 이미 차감된 포인트가 자동으로 환불돼요 |

## 수익 배분과 보상

-   다른 사람의 소프트웨어나 확장 프로그램을 사용하면 작업에 개발자 ID가 포함될 수 있어요. 개발자는 수익을 배분받지만 내가 내는 포인트에는 영향이 없어요. 직접 소프트웨어를 개발한다면 [개발자 수익 배분](https://docs.yescaptcha.com/ko/account/developer.md)을 참고하세요.
-   다른 사람을 추천해 가입시키는 방법은 [추천 보상](https://docs.yescaptcha.com/ko/account/referral.md)을 참고하세요.