# 정액제 신청 / 포인트 관리

## 1. GetFlatRateState - 정액제 서비스 상태 확인

홈택스수집 정액제 서비스 상태를 확인합니다.

```vb
Function GetFlatRateState(CorpNum, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**HTTIFlatRate**

- referenceID `type: String` `length: 10` `description: 사업자번호 ('-' 제외)`
- contractDT `type: String` `length: 14` `description: 정액제 서비스 시작일시`
  - 형식 : yyyyMMddHHmmss
- useEndDate `type: String` `length: 8` `description: 정액제 서비스 만료일자`
  - 형식 : yyyyMMdd
- baseDate `type: Integer` `length: 2` `description: 자동연장 결제일 : 5 / 15 / 25 중 반환`
- state `type: String` `length: 1` `description: 정액제 서비스 상태`
  - `1`: 사용 또는 사용제한
  - `2`: 해지
- closeRequestYN `type: Boolean` `length: -` `description: 정액제 서비스 해지신청 여부`
  - `True`: 신청
  - `False`: 미신청
- useRestrictYN `type: Boolean` `length: -` `description: 정액제 서비스 해지 여부`
  - `True`: 사용제한
  - `False`: 사용
- closeOnExpired `type: Boolean` `length: -` `description: 정액제 서비스 해지 구분`
  - `True`: 일반해지 (정액제 서비스 만료일 해지)
  - `False`: 중도해지 (요청 즉시 해지)
- unPaidYN `type: Boolean` `length: -` `description: 미수금 보유 여부`
  - `True`: 보유
  - `False`: 미보유

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 2. GetFlatRatePopUpURL - 정액제 신청 팝업 URL

![정액제 신청 팝업 URL 미리보기](https://developers.popbill.com/images/reference/point/getFlatRatePopUpURL_httaxinvoice.png)

**정액제를 신청하는 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 800px / height = 700px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

```vb
Function GetFlatRatePopUpURL(CorpNum, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

String - 요청에 대한 응답 URL

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 3. GetChargeInfo - 과금정보 확인

팝빌 홈택스수집 API 서비스 과금정보를 확인합니다.

```vb
Function GetChargeInfo(CorpNum, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**ChargeInfo**

- unitCost `type: String` `length: 12` `description: 요금`
- chargeMethod `type: String` `length: 3` `description: 과금유형`
  - `연동`
  - `파트너`
- rateSystem `type: String` `length: 3` `description: 요금제도`
  - `정액제`
  - `종량제`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 4. GetBalance - 연동회원 잔여포인트 확인

연동회원의 잔여포인트를 확인합니다.

```vb
Function GetBalance(CorpNum)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`

### 응답

String - 연동회원 잔여포인트

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 5. GetChargeURL - 연동회원 포인트 충전 팝업 URL

![연동회원 포인트 충전 팝업 URL 미리보기](https://developers.popbill.com/images/reference/point/getChargeURL.png)

**연동회원 포인트를 충전하는 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 800px / height = 700px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

```vb
Function GetChargeURL(CorpNum, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

String - 요청에 대한 응답 URL

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 6. PaymentRequest - 연동회원 무통장 입금신청

연동회원 포인트 충전을 위해 무통장입금을 신청합니다.

```vb
Function paymentRequest(CorpNum, PaymentForm, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- PaymentForm `type: PaymentForm` `length: -` `required: Y` `description: 입금신청 객체정보`
  - settlerName `type: String` `length: 100` `required: N` `description: 담당자명`
  - settlerEmail `type: String` `length: 100` `required: N` `description: 담당자 메일`
  - notifyHP `type: String` `length: 20` `required: N` `description: 담당자 휴대폰`
    - 무통장 입금 승인 알림톡이 전송될 번호
  - paymentName `type: String` `length: 70` `required: Y` `description: 입금자명`
  - settleCost `type: String` `length: 18` `required: Y` `description: 결제금액`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**PaymentResponse**

- code `type: Long` `length: -` `description: 응답코드`
- message `type: String` `length: -` `description: 응답메시지`
- settleCode `type: String` `length: 18` `description: 정산코드`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 7. GetSettleResult - 연동회원 무통장 입금신청 정보확인

연동회원 포인트 무통장 입금신청내역 1건을 확인합니다.

```vb
Function getSettleResult(CorpNum, SettleCode, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SettleCode `type: String` `length: 18` `required: Y` `description: 정산코드`
  - 팝빌에서 임의 할당하는 값으로 [\[PaymentRequest - 연동회원 무통장 입금신청\]](https://developers.popbill.com/reference/httaxinvoice/asp/common-api/point#PaymentRequest) 호출시 반환되는 값
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**PaymentHistory**

- productType `type: String` `length: 3` `description: 결제 내용`
  - `포인트`
  - `정액제`
  - `미수금`
- productName `type: String` `length: 30` `description: 결제 상품명`
- settleType `type: String` `length: 7` `description: 결제유형`
  - `무통장`
  - `신용카드`
  - `실시간계좌이체`
- settlerName `type: String` `length: 100` `description: 담당자명`
- settlerEmail `type: String` `length: 100` `description: 담당자메일`
- settleCost `type: String` `length: 18` `description: 결제금액`
- settlePoint `type: String` `length: 18` `description: 충전포인트`
- settleState `type: Integer` `length: 1` `description: 결제상태`
  - `1`: 대기
  - `2`: 승인
  - `3`: 실패
  - `4`: 취소
  - `5`: 취소
- regDT `type: String` `length: 14` `description: 등록일시`
  - 형식 : yyyyMMddHHmmss
- stateDT `type: String` `length: 14` `description: 상태일시`
  - 형식 : yyyyMMddHHmmss

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 8. GetPaymentHistory - 연동회원 포인트 결제내역 확인

연동회원의 포인트 결제내역을 확인합니다.

```vb
Function GetPaymentHistory(CorpNum, SDate, EDate, Page, PerPage, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SDate `type: String` `length: 8` `required: Y` `description: 검색 시작일자`
  - 형식 : yyyyMMdd
- EDate `type: String` `length: 8` `required: Y` `description: 검색 종료일자`
  - 형식 : yyyyMMdd
- Page `type: Integer` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- PerPage `type: Integer` `length: -` `required: N` `description: 페이지당 표시할 목록 건수`
  - 최대 : 1,000건
  - 기본값 : 500건
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**PaymentHistoryResult**

- code `type: Long` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- total `type: Long` `length: -` `description: 총 검색결과 건수`
- perPage `type: Long` `length: -` `description: 페이지당 목록 건수`
- pageNum `type: Long` `length: -` `description: 페이지 번호`
- pageCount `type: Long` `length: -` `description: 페이지 개수`
- list `type: List<PaymentHistory>` `length: -` `description: 결제내역`
  - productType `type: String` `length: 3` `description: 결제 내용`
    - `포인트`
    - `정액제`
    - `미수금`
  - productName `type: String` `length: 30` `description: 결제 상품명`
  - settleType `type: String` `length: 7` `description: 결제유형`
    - `무통장`
    - `신용카드`
    - `실시간계좌이체`
  - settlerName `type: String` `length: 100` `description: 담당자명`
  - settlerEmail `type: String` `length: 100` `description: 담당자메일`
  - settleCost `type: String` `length: 18` `description: 결제금액`
  - settlePoint `type: String` `length: 18` `description: 충전포인트`
  - settleState `type: Integer` `length: 1` `description: 결제상태`
    - `1`: 대기
    - `2`: 승인
    - `3`: 실패
    - `4`: 취소
    - `5`: 취소
  - regDT `type: String` `length: 14` `description: 등록일시`
    - 형식 : yyyyMMddHHmmss
  - stateDT `type: String` `length: 14` `description: 상태일시`
    - 형식 : yyyyMMddHHmmss

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 9. GetPaymentURL - 연동회원 포인트 결제내역 팝업 URL

![연동회원 포인트 결제내역 팝업 URL 미리보기](https://developers.popbill.com/images/reference/point/getPaymentURL.png)

**연동회원 포인트 결제내역 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 1,200px (최소 800px) / height = 600px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

```vb
Function GetPaymentURL(CorpNum, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

String - 요청에 대한 응답 URL

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 10. GetUseHistory - 연동회원 포인트 사용내역 확인

- 연동회원의 포인트 사용내역을 확인합니다.

```vb
Function getUseHistory(CorpNum, SDate, EDate, Page, PerPage, Order, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SDate `type: String` `length: 8` `required: Y` `description: 검색 시작일자`
  - 형식 : yyyyMMdd
- EDate `type: String` `length: 8` `required: Y` `description: 검색 종료일자`
  - 형식 : yyyyMMdd
- Page `type: Integer` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- PerPage `type: Integer` `length: -` `required: N` `description: 페이지당 표시할 목록 건수`
  - 최대 : 1,000건
  - 기본값 : 500건
- Order `type: String` `length: 1` `required: N` `description: 거래일자를 기준으로 하는 목록 정렬 방향`
  - `D`: 내림차순 : 기본값
  - `A`: 오름차순
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**UseHistoryResult**

- code `type: Long` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- total `type: Long` `length: -` `description: 총 검색결과 건수`
- perPage `type: Long` `length: -` `description: 페이지당 목록 건수`
- pageNum `type: Long` `length: -` `description: 페이지 번호`
- pageCount `type: Long` `length: -` `description: 페이지 개수`
- list `type: List<UseHistory>` `length: -` `description: 사용내역`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 11. GetUseHistoryURL - 연동회원 포인트 사용내역 팝업 URL

![연동회원 포인트 사용내역 팝업 URL 미리보기](https://developers.popbill.com/images/reference/point/getUseHistoryURL.png)

**연동회원 포인트 사용내역 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 1,200px (최소 800px) / height = 600px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

```vb
Function GetUseHistoryURL(CorpNum, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

String - 요청에 대한 응답 URL

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 12. Refund - 연동회원 포인트 환불신청

연동회원 포인트를 환불 신청합니다.

```vb
Function Refund(CorpNum, RefundForm, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- RefundForm `type: RefundForm` `length: -` `required: Y` `description: 환불신청 객체정보`
  - contactName `type: String` `length: 100` `required: Y` `description: 담당자명`
  - tel `type: String` `length: 20` `required: Y` `description: 담당자 연락처`
  - requestPoint `type: String` `length: 18` `required: Y` `description: 환불 신청 포인트`
  - accountBank `type: String` `length: 10` `required: Y` `description: 은행명`
  - accountNum `type: String` `length: 50` `required: Y` `description: 계좌번호`
  - accountName `type: String` `length: 70` `required: Y` `description: 예금주명`
  - reason `type: String` `length: 200` `required: N` `description: 환불사유`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**RefundResponse**

- code `type: Long` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- message `type: String` `length: -` `description: API 처리에 대한 응답메시지`
- refundCode `type: String` `length: 18` `description: 환불코드`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 13. GetRefundHistory - 연동회원 포인트 환불내역 확인

연동회원의 포인트 환불신청내역을 확인합니다.

```vb
Function GetRefundHistory(CorpNum, Page, PerPage, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- Page `type: Integer` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- PerPage `type: Integer` `length: -` `required: N` `description: 페이지당 표시할 목록 건수`
  - 최대 : 1,000건
  - 기본값 : 500건
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**RefundHistoryResult**

- code `type: Long` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- total `type: Long` `length: -` `description: 총 검색결과 건수`
- perPage `type: Long` `length: -` `description: 페이지당 목록 건수`
- pageNum `type: Long` `length: -` `description: 페이지 번호`
- pageCount `type: Long` `length: -` `description: 페이지 개수`
- list `type: List<RefundHistory>` `length: -` `description: 환불내역`
  - reqDT `type: String` `length: 14` `description: 신청일시`
    - 형식 : yyyyMMddHHmmss
  - requestPoint `type: String` `length: 18` `description: 환불 신청포인트`
  - accountBank `type: String` `length: 10` `description: 환불계좌 은행명`
  - accountNum `type: String` `length: 50` `description: 환불계좌번호`
  - accountName `type: String` `length: 70` `description: 환불계좌 예금주명`
  - state `type: Integer` `length: 1` `description: 상태`
    - `1`: 접수대기
    - `2`: 심사중
    - `3`: 입금대기
    - `4`: 환불완료
    - `5`: 취소
  - reason `type: String` `length: 200` `description: 환불사유`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 14. GetPartnerBalance - 파트너 잔여포인트 확인

파트너의 잔여포인트를 확인합니다.

```vb
Function GetPartnerBalance(CorpNum)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`

### 응답

String - 파트너 잔여포인트

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 15. GetPartnerURL - 파트너 포인트 충전 팝업 URL

![파트너 포인트 충전 팝업 URL 미리보기](https://developers.popbill.com/images/reference/point/getPartnerURL.png)

**파트너 포인트를 충전하는 팝업 URL을 반환합니다.**

- 권장 사이즈 : width = 800px / height = 700px
- 반환되는 URL은 30초 동안만 사용이 가능합니다.
- 반환되는 URL에서만 유효한 세션을 포함하고 있습니다.

```vb
Function GetPartnerURL(CorpNum, TOGO)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- TOGO `type: String` `length: 4` `required: Y` `description: 고정값 : "CHRG"`

### 응답

String - 요청에 대한 응답 URL

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 16. GetRefundInfo - 환불 신청 상태 조회

포인트 환불에 대한 상세정보 1건을 확인합니다.

```vb
Function GetRefundInfo(CorpNum, RefundCode, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- RefundCode `type: String` `length: 18` `required: Y` `description: 환불코드`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**RefundHistory**

- reqDT `type: String` `length: 14` `description: 신청일시`
  - 형식 : yyyyMMddHHmmss
- requestPoint `type: String` `length: 18` `description: 환불 신청포인트`
- accountBank `type: String` `length: 10` `description: 환불계좌 은행명`
- accountNum `type: String` `length: 50` `description: 환불계좌번호`
- accountName `type: String` `length: 70` `description: 환불계좌 예금주명`
- state `type: Integer` `length: 1` `description: 상태`
  - `1`: 접수대기
  - `2`: 심사중
  - `3`: 입금대기
  - `4`: 환불완료
  - `5`: 취소
- reason `type: String` `length: 200` `description: 환불사유`

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`

## 17. GetRefundableBalance - 환불 가능 포인트 조회

환불 가능한 포인트를 확인합니다. (보너스 포인트는 환불 가능 포인트에서 제외됩니다.)

```vb
Function GetRefundableBalance(CorpNum, UserID)
```

### 요청

**Parameters**

- CorpNum `type: String` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- UserID `type: String` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

Double - 환불 가능 포인트

### 예외

**Err**

- Number `type: Long` `length: -` `description: API 처리 실패에 대한 오류코드`
  - 음의 정수 8자리 숫자값 [\[참고\] 오류코드](https://developers.popbill.com/error-code)
- Description `type: String` `length: -` `description: API 처리 실패에 대한 오류메시지`