> For the complete documentation index, see [llms.txt](https://developers.payssam.kr/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.payssam.kr/api/api-v2/error-code.md).

# 에러 코드 v2

### 기본 응답코드

<table><thead><tr><th width="119.9765625">code</th><th width="91.69140625">status</th><th>message</th><th>발생 조건</th></tr></thead><tbody><tr><td>0000</td><td>정상</td><td>성공하였습니다.</td><td>모든 V2 API 정상 응답</td></tr><tr><td>ERROR</td><td>실패</td><td>처리 중 오류가 발생하였습니다.</td><td>알 수 없는 서버 오류 또는 미분류 예외</td></tr></tbody></table>

### 파트너 에러코드

<table><thead><tr><th width="157.31640625">code</th><th width="96.3828125">status</th><th>message</th><th>발생 조건</th></tr></thead><tbody><tr><td>PARTNER_001</td><td>실패</td><td>V2 버전의 파트너 하위 사업장 연동이 불가능한 파트너입니다.</td><td>apiKey가 V2 미지원 파트너로 식별된 경우</td></tr><tr><td>PARTNER_002</td><td>실패</td><td>apiKey 정보를 확인할 수 없습니다.</td><td>요청에 apiKey가 누락되었거나 형식이 잘못된 경우</td></tr><tr><td>PARTNER_003</td><td>실패</td><td>정상적인 파트너가 아닙니다.</td><td>apiKey로 파트너/매장/결제수단을 조회할 수 없는 경우</td></tr><tr><td>PARTNER_004</td><td>실패</td><td>찾을 수 없는 하위사업장 연동 정보입니다.</td><td>merchantId 또는 매핑 시퀀스로 매장 인증 정보를 찾지 못한 경우</td></tr><tr><td>PARTNER_005</td><td>실패</td><td>존재하지 않는 파트너입니다.</td><td>파트너 조회 실패</td></tr><tr><td>PARTNER_006</td><td>실패</td><td>적용중인 파트너 계약이 없습니다.</td><td>파트너 계약(서비스) 상태가 비활성인 경우</td></tr><tr><td>PARTNER_007</td><td>실패</td><td>제공되지 않는 서비스입니다.</td><td>파트너에게 해당 서비스(청구서 발송 발송 등) 권한이 없는 경우</td></tr></tbody></table>

### 파트너 맵핑 에러코드

<table><thead><tr><th>code</th><th width="92.20703125">status</th><th>message</th><th>발생 조건</th></tr></thead><tbody><tr><td>PARTNER_MAPPING_001</td><td>실패</td><td>apiKey, memberId, merchantId는 필수 값입니다.</td><td>파트너 매핑 요청 시 필수 필드 누락</td></tr><tr><td>PARTNER_MAPPING_002</td><td>실패</td><td>잘못된 사업장등록번호 포맷입니다. 숫자 10자리를 입력하십시오.</td><td>사업자등록번호가 10자리 숫자가 아닌 경우</td></tr><tr><td>PARTNER_MAPPING_003</td><td>실패</td><td>파트너 하위사업장 심사 정보를 확인할 수 없습니다.</td><td>매장 심사(application) 정보 조회 실패</td></tr><tr><td>PARTNER_MAPPING_004</td><td>실패</td><td>삭제된 임시사업장을 연동할 수 없습니다.</td><td>삭제된 임시사업장으로 매핑 시도</td></tr><tr><td>PARTNER_MAPPING_005</td><td>실패</td><td>해당 파트너사에서 이미 맵핑된 임시사업장입니다.</td><td>동일 파트너에 중복 매핑 시도</td></tr><tr><td>PARTNER_MAPPING_006</td><td>실패</td><td>개시된 매장이 존재하지 않습니다.</td><td>매핑 대상 매장 중 개시 상태인 매장을 찾을 수 없음</td></tr><tr><td>PARTNER_MAPPING_007</td><td>실패</td><td>처리 불가능한 회원입니다.</td><td>회원 상태가 매핑/처리 불가 상태인 경우</td></tr></tbody></table>

### 값 검증 에러 코드

<table><thead><tr><th width="163.328125">code</th><th width="92.0703125">status</th><th width="246.8984375">message</th><th>발생조건</th></tr></thead><tbody><tr><td>VALIDATION_001</td><td>실패</td><td>정상적이지 않은 데이터입니다. 연동규격서를 확인하시기 바랍니다.</td><td>요청값 검증 실패(필드 누락/형식 불일치)</td></tr><tr><td>VALIDATION_002</td><td>실패</td><td>정상적이지 않은 데이터입니다. 해싱값을 확인하시기 바랍니다.</td><td>hash 검증 실패</td></tr></tbody></table>

### 결제 에러 코드

<table><thead><tr><th width="152.3046875">code</th><th width="100.1484375">status</th><th>message</th><th>발생조건</th></tr></thead><tbody><tr><td>PAYMENT_001</td><td>실패</td><td>결제를 처리 할 수 없습니다</td><td>VAN/현금영수증 발행 응답 누락·실패</td></tr><tr><td>PAYMENT_002</td><td>실패</td><td>결제 취소에 실패하였습니다.</td><td>결제/현금영수증 취소 시 정산·VAN·은행 응답 실패</td></tr><tr><td>PAYMENT_003</td><td>실패</td><td>100원 이상 청구할 수 있습니다.</td><td>청구 금액이 100원 미만</td></tr><tr><td>PAYMENT_004</td><td>실패</td><td>비정상적인 VAN 입니다.</td><td>결제수단(payType) 조회 실패 또는 사용 불가</td></tr><tr><td>PAYMENT_005</td><td>실패</td><td>개발 환경에서는 20000원 이상의 금액만 청구할 수 있습니다.</td><td>dev 환경에서 청구 금액이 20,000원 미만</td></tr></tbody></table>

### 청구서 에러 코드

<table><thead><tr><th width="210.47265625">code</th><th width="94.25390625">status</th><th>message</th><th>발생조건</th></tr></thead><tbody><tr><td>BILL_001</td><td>실패</td><td>이미 사용된 billId 입니다.</td><td>동일 billId 로 청구서 재생성 시도</td></tr><tr><td>BILL_002</td><td>실패</td><td>기 취소된 청구서 입니다.</td><td>직접 취소 요청 시 취소 가능 상태 아님</td></tr><tr><td>BILL_003</td><td>실패</td><td>청구서를 찾을 수 없습니다.</td><td>billId/ledger/현금영수증 단건 조회 실패</td></tr><tr><td>BILL_004</td><td>실패</td><td>결제카드를 조회할 수 없습니다.</td><td>Keyin 카드 정보 복호화 실패</td></tr><tr><td>BILL_005</td><td>실패</td><td>요청한 txId로 청구서를 찾을 수 없습니다.</td><td>결과 콜백 또는 ledger 조회에서 txId 매칭 실패</td></tr><tr><td>BILL_006</td><td>실패</td><td>청구서 발송이 가능한 상태가 아닙니다.</td><td>재발송 시 청구서 상태가 발송 불가</td></tr><tr><td>BILL_007</td><td>실패</td><td>billId는 20자 이하여야 합니다.</td><td>요청 billId 길이 초과</td></tr><tr><td>BILL_008</td><td>실패</td><td>sendType은 필수값입니다. (TALK 또는 URL)</td><td>v2 청구서 생성시 타입 누락</td></tr><tr><td>BILL_009</td><td>실패</td><td>BILL_TALK 서비스를 사용할 수 없습니다.</td><td>파트너 계약시 TALK 타입 계약 되지 않음</td></tr><tr><td>BILL_010</td><td>실패</td><td>BILL_URL 서비스를 사용할 수 없습니다.</td><td>파트너 계약시 URL 타입 계약 되지 않음</td></tr></tbody></table>

### 포인트 에러 코드

<table><thead><tr><th width="128.921875">code</th><th width="89.00390625">status</th><th>message</th><th>발생조건</th></tr></thead><tbody><tr><td>POINT_001</td><td>실패</td><td>포인트가 부족합니다</td><td>청구서 발송 시 쌤포인트 잔액 부족</td></tr></tbody></table>

### 점검중 에러 코드

<table><thead><tr><th width="207.71484375">code</th><th width="110.1953125">status</th><th width="132.421875">message</th><th>발생조건</th></tr></thead><tbody><tr><td>MAINTAINED_METHOD</td><td>실패</td><td>점검 중입니다.</td><td>야간작업, 장애 처리 등 점검 필요시</td></tr></tbody></table>

***

## <i class="fa-circle-info" style="color:$info;">:circle-info:</i>

<i class="fa-messages-question">:messages-question:</i>  더 궁금한 내용이 있나요? [자주하는 질문](https://developers.payssam.kr/faq/)

<i class="fa-message-code">:message-code:</i>  기술지원이 필요하신가요? [이메일 보내기](mailto:partner_dev@paymint.co.kr)


---

# Agent Instructions
This documentation is published with GitBook. GitBook is the documentation platform designed so that both humans and AI agents can read, navigate, and reason over technical content effectively. Learn more at gitbook.com.

## Querying This Documentation
If you need additional information that is not directly available in this page, you can query the documentation dynamically by asking a question.

Perform an HTTP GET request on the current page URL with the `ask` query parameter, and the optional `goal` query parameter:

```
GET https://developers.payssam.kr/api/api-v2/error-code.md?ask=<question>&goal=<endgoal>
```

`ask` is the immediate question: it should be specific, self-contained, and written in natural language.
`goal` is optional and describes the broader end goal you are ultimately trying to accomplish on behalf of the user. GitBook uses it to tailor the answer towards what is most useful for that goal.

The response will contain a direct answer to the question and relevant excerpts and sources from the documentation.

Use this mechanism when the answer is not explicitly present in the current page, you need clarification or additional context, or you want to retrieve related documentation sections.