# 팩스전송

## 1. SendFax - 팩스 전송

팩스 1건을 팝빌에 접수합니다. (최대 전송파일 개수: 30개)

```python
def sendFax(CorpNum, SenderNum, ReceiverNum, ReceiverName, FilePath, ReserveDT=None, UserID=None, SenderName=None, adsYN=False, title=None, RequestNum=None)
```

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SenderNum `type: str` `length: 20` `required: Y` `description: 발신번호`
  - 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
- ReceiverNum `type: str` `length: 20` `required: Y` `description: 수신번호`
- ReceiverName `type: str` `length: 30` `required: N` `description: 수신자명`
- FilePath `type: list` `length: -` `required: Y` `description: 파일 목록`
  - [\[참고\] 권장 파일 확장자](https://developers.popbill.com/reference/fax/python/api#available-extension)
  - 최대 : 30개
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
- adsYN `type: bool` `length: -` `required: N` `description: 광고팩스 전송 여부`
  - `true`: 광고
  - `false`: 일반 : 기본값
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 2. SendFax\_multi - 팩스 전송 (동보전송)

- 팩스를 다수의 수신자에게 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수 : 30개) (최대 1,000건)

```python
def sendFax_multi(CorpNum, SenderNum, Receiver, FilePath, ReserveDT=None, UserID=None, SenderName=None, adsYN=False, title=None, RequestNum=None)
```

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SenderNum `type: str` `length: 20` `required: Y` `description: 발신번호`
  - 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
- Receiver `type: FaxReceiver[ ]` `length: -` `required: Y` `description: 수신자 정보`
  - 최대 : 1,000건
  - receiveNum `type: str` `length: 20` `required: Y` `description: 팩스 단말기 번호 또는 인터넷 팩스 번호`
  - receiveName `type: str` `length: 30` `required: N` `description: 수신자명`
  - interOPRefKey `type: str` `length: 20` `required: N` `description: 파트너 지정키`
    - 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
- FilePath `type: list` `length: -` `required: Y` `description: 파일 목록`
  - [\[참고\] 권장 파일 확장자](https://developers.popbill.com/reference/fax/python/api#available-extension)
  - 최대 : 30개
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
- adsYN `type: bool` `length: -` `required: N` `description: 광고팩스 전송 여부`
  - `true`: 광고
  - `false`: 일반 : 기본값
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 3. SendFaxBinary - 팩스 전송 (바이너리)

전송할 파일의 바이너리 데이터로 팩스 1건을 팝빌에 접수합니다. (최대 전송파일 개수: 30개)

```python
def sendFaxBinary(CorpNum, SenderNum, ReceiverNum, ReceiverName, FileDatas, ReserveDT=None, UserID=None, SenderName=None, adsYN=False, title=None, RequestNum=None)
```

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SenderNum `type: str` `length: 20` `required: Y` `description: 발신번호`
  - 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
- ReceiverNum `type: str` `length: 20` `required: Y` `description: 수신번호`
- ReceiverName `type: str` `length: 30` `required: N` `description: 수신자명`
- FileDatas `type: FileData[ ]` `length: -` `required: Y` `description: 파일 목록`
  - [\[참고\] 권장 파일 확장자](https://developers.popbill.com/reference/fax/python/api#available-extension)
  - 최대 : 30개
  - fileName `type: str` `length: 255` `required: Y` `description: 팩스로 전송할 파일명`
  - fileData `type: bytes` `length: -` `required: Y` `description: 팩스로 전송할 파일의 바이너리 데이터`
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
- adsYN `type: bool` `length: -` `required: N` `description: 광고팩스 전송 여부`
  - `true`: 광고
  - `false`: 일반 : 기본값
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 4. SendFaxBinary\_multi - 팩스 전송 (바이너리 동보전송)

전송할 파일의 바이너리 데이터로 다수의 수신자에게 팩스를 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수 : 30개) (최대 1,000건)

```python
def sendFaxBinary_multi(CorpNum, SenderNum, Receiver, FileDatas, ReserveDT=None, UserID=None, SenderName=None, adsYN=False, title=None, RequestNum=None)
```

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SenderNum `type: str` `length: 20` `required: Y` `description: 발신번호`
  - 팝빌에 사전등록되지 않은 발신번호를 입력시 '원발신번호'로 전송됨
- Receiver `type: FaxReceiver[ ]` `length: -` `required: Y` `description: 수신자 정보`
  - 최대 : 1,000건
  - receiveNum `type: str` `length: 20` `required: Y` `description: 팩스 단말기 번호 또는 인터넷 팩스 번호`
  - receiveName `type: str` `length: 30` `required: N` `description: 수신자명`
  - interOPRefKey `type: str` `length: 20` `required: N` `description: 파트너 지정키`
    - 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
- FileDatas `type: FileData[ ]` `length: -` `required: Y` `description: 파일 목록`
  - [\[참고\] 권장 파일 확장자](https://developers.popbill.com/reference/fax/python/api#available-extension)
  - 최대 : 30개
  - fileName `type: str` `length: 255` `required: Y` `description: 팩스로 전송할 파일명`
  - fileData `type: bytes` `length: -` `required: Y` `description: 팩스로 전송할 파일의 바이너리 데이터`
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
- adsYN `type: bool` `length: -` `required: N` `description: 광고팩스 전송 여부`
  - `true`: 광고
  - `false`: 일반 : 기본값
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 5. ResendFax - 팩스 재전송 (접수번호)

팝빌에서 반환받은 접수번호를 통해 팩스 1건을 재전송합니다.

- 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

```python
def resendFax(CorpNum, ReceiptNum, SenderNum, SenderName, ReceiverNum, ReceiverName, ReserveDT=None, UserID=None, title=None, RequestNum=None)
```

> **팩스 재전송이 가능한 상태는 다음과 같습니다.**
>
> 1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
> 2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우
>
> **재전송이 가능한 변환 실패 코드는 아래와 같습니다.**
>
> - 414 : 팩스 변환 실패
> - 415 : 팩스 변환 시간 초과
> - 416 : 팩스 파일 처리 중 오류
> - 498 : 기타 오류로 인한 변환 실패

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- ReceiptNum `type: str` `length: 18` `required: Y` `description: 원본 팩스 접수번호`
- SenderNum `type: str` `length: 20` `required: N` `description: 발신번호`
  - 발신번호를 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신번호
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
  - 발신자명을 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신자명
- ReceiverNum `type: str` `length: 20` `required: N` `description: 수신번호`
  - 수신번호를 변경해야할 경우 사용
  - 기본값 : 원본 팩스 수신번호
- ReceiverName `type: str` `length: 30` `required: N` `description: 수신자명`
  - 수신자명을 변경해야할 경우 사용
  - 기본값 : 원본 팩스 수신자명
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 6. ResendFax\_multi - 팩스 재전송 (접수번호 동보전송)

동일한 팩스파일을 다수의 수신자에게 전송하기 위해 팝빌에 접수합니다. (최대 전송파일 개수: 30개) (최대 1,000건)

- 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

```python
def resendFax_multi(CorpNum, ReceiptNum, SenderNum, SenderName, Receiver, ReserveDT=None, UserID=None, title=None, RequestNum=None)
```

> **팩스 재전송이 가능한 상태는 다음과 같습니다.**
>
> 1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
> 2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우
>
> **재전송이 가능한 변환 실패 코드는 아래와 같습니다.**
>
> - 414 : 팩스 변환 실패
> - 415 : 팩스 변환 시간 초과
> - 416 : 팩스 파일 처리 중 오류
> - 498 : 기타 오류로 인한 변환 실패

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- ReceiptNum `type: str` `length: 18` `required: Y` `description: 원본 팩스 접수번호`
- SenderNum `type: str` `length: 20` `required: N` `description: 발신번호`
  - 발신번호를 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신번호
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
  - 발신자명을 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신자명
- Receiver `type: FaxReceiver[ ]` `length: -` `required: N` `description: 수신자 정보`
  - 최대 : 1,000건
  - receiveNum `type: str` `length: 20` `required: Y` `description: 팩스 단말기 번호 또는 인터넷 팩스 번호`
  - receiveName `type: str` `length: 30` `required: N` `description: 수신자명`
  - interOPRefKey `type: str` `length: 20` `required: N` `description: 파트너 지정키`
    - 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 7. ResendFaxRN - 팩스 재전송 (요청번호)

파트너가 할당한 요청번호를 통해 팩스 1건을 재전송합니다.

- 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

```python
def resendFaxRN(CorpNum, OrgRequestNum, SenderNum, SenderName, ReceiverNum, ReceiverName, ReserveDT=None, UserID=None, title=None, RequestNum=None)
```

> **팩스 재전송이 가능한 상태는 다음과 같습니다.**
>
> 1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
> 2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우
>
> **재전송이 가능한 변환 실패 코드는 아래와 같습니다.**
>
> - 414 : 팩스 변환 실패
> - 415 : 팩스 변환 시간 초과
> - 416 : 팩스 파일 처리 중 오류
> - 498 : 기타 오류로 인한 변환 실패

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- OrgRequestNum `type: str` `length: 36` `required: Y` `description: 원본 팩스 요청번호`
- SenderNum `type: str` `length: 20` `required: N` `description: 발신번호`
  - 발신번호를 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신번호
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
  - 발신자명을 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신자명
- ReceiverNum `type: str` `length: 20` `required: N` `description: 수신번호`
  - 수신번호를 변경해야할 경우 사용
  - 기본값 : 원본 팩스 수신번호
- ReceiverName `type: str` `length: 30` `required: N` `description: 수신자명`
  - 수신자명을 변경해야할 경우 사용
  - 기본값 : 원본 팩스 수신자명
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 8. ResendFaxRN\_multi - 팩스 재전송 (요청번호 동보전송)

파트너가 할당한 요청번호를 통해 다수건의 팩스를 재전송합니다. (최대 전송파일 개수: 30개) (최대 1,000건)

- 발신/수신 정보 미입력시 기존과 동일한 정보로 팩스가 전송되고, 접수일 기준 최대 60일이 경과되지 않는 건만 재전송이 가능합니다.

```python
def resendFaxRN_multi(CorpNum, OrgRequestNum, SenderNum, SenderName, Receiver, ReserveDT=None, UserID=None, title=None, RequestNum=None)
```

> **팩스 재전송이 가능한 상태는 다음과 같습니다.**
>
> 1. 원본 팩스 접수 후 60일 이내이며, 최초 팩스 전송 시 변환에 성공한 경우
> 2. 최초 팩스 전송 시 변환에 실패했으나 재전송이 가능한 경우
>
> **재전송이 가능한 변환 실패 코드는 아래와 같습니다.**
>
> - 414 : 팩스 변환 실패
> - 415 : 팩스 변환 시간 초과
> - 416 : 팩스 파일 처리 중 오류
> - 498 : 기타 오류로 인한 변환 실패

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- OrgRequestNum `type: str` `length: 36` `required: Y` `description: 원본 팩스 요청번호`
- SenderNum `type: str` `length: 20` `required: N` `description: 발신번호`
  - 발신번호를 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신번호
- SenderName `type: str` `length: 100` `required: N` `description: 발신자명`
  - 발신자명을 변경해야할 경우 사용
  - 기본값 : 원본 팩스 발신자명
- Receiver `type: FaxReceiver[ ]` `length: -` `required: N` `description: 수신자 정보`
  - 수신자 정보를 변경해야할 경우 사용
  - 최대 : 1,000건
  - 기본값 : 원본 팩스 수신자 정보
  - receiveNum `type: str` `length: 20` `required: Y` `description: 팩스 단말기 번호 또는 인터넷 팩스 번호`
  - receiveName `type: str` `length: 30` `required: N` `description: 수신자명`
  - interOPRefKey `type: str` `length: 20` `required: N` `description: 파트너 지정키`
    - 팩스 대량/동보전송시 파트너가 개별건마다 입력할 수 있는 값
- ReserveDT `type: str` `length: 14` `required: N` `description: 전송 예약일시`
  - 형식 : yyyyMMddHHmmss
  - 기본값 : 즉시전송
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`
- title `type: str` `length: 100` `required: N` `description: 팩스제목`
- RequestNum `type: str` `length: 36` `required: N` `description: 요청번호`
  - 파트너가 접수 단위를 식별하기 위해 할당하는 관리번호
  - 영문 대소문자, 숫자, 특수문자('-','\_')만 이용 가능

### 응답

str - 요청에 대한 접수번호(receiptNum)

### 예외

**PopbillException**

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

## 9. CancelReserve - 예약전송 취소 (접수번호)

팝빌에서 반환받은 접수번호로 예약된 팩스를 전송 취소합니다. (예약시간 10분 전까지 가능)

```python
def cancelReserve(CorpNum, ReceiptNum, UserID=None)
```

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- ReceiptNum `type: str` `length: 18` `required: Y` `description: 팝빌에서 할당한 접수번호`
  - 팩스 예약전송 요청의 반환값
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**Response**

- code `type: int` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- message `type: str` `length: -` `description: API 처리에 대한 응답메시지`

### 예외

**PopbillException**

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

## 10. CancelReserveRN - 예약전송 취소 (요청번호)

파트너가 할당한 요청번호로 예약된 팩스를 전송 취소합니다. (예약시간 10분 전까지 가능)

```python
def cancelReserveRN(CorpNum, RequestNum, UserID=None)
```

### 요청

**Parameters**

- CorpNum `type: str` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- RequestNum `type: str` `length: 36` `required: Y` `description: 파트너가 할당한 요청번호`
- UserID `type: str` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

**Response**

- code `type: int` `length: -` `description: API 처리에 대한 응답코드`
  - `1`: 성공
- message `type: str` `length: -` `description: API 처리에 대한 응답메시지`

### 예외

**PopbillException**

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