# 포인트 관리

## 1. GetUnitCost - 전송 단가 확인

카카오톡 전송시 과금되는 포인트 단가를 확인합니다.

```csharp
Single GetUnitCost(string CorpNum, KakaoType msgType, string UserID = null)
```

### 요청

**Parameters**

- CorpNum `type: string` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- msgType `type: KakaoType` `length: -` `required: Y` `description: 카카오톡 유형`
  - `ATS`: 알림톡
  - `BMS_I`: 브랜드 메시지 채널 친구(I)
  - `BMS_M`: 브랜드 메시지 전체(M)
  - `BMS_N`: 브랜드 메시지 비채널 친구(N)
  - ATS `type: enum` `length: -` `required: N` `description: 알림톡`
  - BMS\_I `type: enum` `length: -` `required: N` `description: 브랜드 메시지 채널 친구(I)`
  - BMS\_M `type: enum` `length: -` `required: N` `description: 브랜드 메시지 전체(M)`
  - BMS\_N `type: enum` `length: -` `required: N` `description: 브랜드 메시지 비채널 친구(N)`
- UserID `type: string` `length: 50` `required: N` `description: 팝빌회원 아이디`

### 응답

Single - 카카오톡 전송단가

### 예외

**PopbillException**

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

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

팝빌 카카오톡 API 서비스 과금정보를 확인합니다.

```csharp
ChargeInfo GetChargeInfo(string CorpNum, KakaoType msgType, string UserID = null)
```

### 요청

**Parameters**

- CorpNum `type: string` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- msgType `type: KakaoType` `length: -` `required: Y` `description: 카카오톡 유형`
  - `ATS`: 알림톡
  - `BMS_I`: 브랜드 메시지 채널 친구(I)
  - `BMS_M`: 브랜드 메시지 전체(M)
  - `BMS_N`: 브랜드 메시지 비채널 친구(N)
  - ATS `type: enum` `length: -` `required: N` `description: 알림톡`
  - BMS\_I `type: enum` `length: -` `required: N` `description: 브랜드 메시지 채널 친구(I)`
  - BMS\_M `type: enum` `length: -` `required: N` `description: 브랜드 메시지 전체(M)`
  - BMS\_N `type: enum` `length: -` `required: N` `description: 브랜드 메시지 비채널 친구(N)`
- 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: 과금제도`
  - `종량제`

### 예외

**PopbillException**

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

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

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

```csharp
double GetBalance(string CorpNum)
```

### 요청

**Parameters**

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

### 응답

double - 연동회원 잔여포인트

### 예외

**PopbillException**

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

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

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

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

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

```csharp
string GetChargeURL(string CorpNum, string UserID)
```

### 요청

**Parameters**

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

### 응답

string - 요청에 대한 응답 URL

### 예외

**PopbillException**

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

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

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

```csharp
UseHistoryResult GetUseHistory(string CorpNum, string SDate, string EDate, int? Page = null, int? PerPage = null, string Order = null, string UserID = null)
```

### 요청

**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: int?` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- PerPage `type: int?` `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: 사용내역`
  - itemCode `type: int` `length: 3` `description: 서비스 코드`
    - `110`: 세금계산서
    - `111`: 홈택스수집(세금)
    - `121`: 거래명세서
    - `122`: 청구서
    - `123`: 견적서
    - `124`: 발주서
    - `125`: 입금표
    - `126`: 영수증
    - `140`: 현금영수증
    - `141`: 홈택스수집(현금)
    - `150`: 문자(SMS)
    - `151`: 문자(LMS)
    - `152`: 문자(MMS)
    - `153`: 알림톡
    - `156`: 브랜드 메시지(I)
    - `157`: 브랜드 메시지(N)
    - `158`: 브랜드 메시지(M)
    - `160`: 팩스(일반망)
    - `161`: 팩스(지능망)
    - `170`: 사업자등록상태조회
    - `171`: 기업정보조회
    - `180`: 계좌조회
    - `182`: 성명조회
    - `183`: 실명조회
  - txType `type: int` `length: 2` `description: 포인트 증감 유형`
    - `11`: (포인트 증가) 포인트 충전
    - `12`: (포인트 증가) 조정
    - `13`: (포인트 증가) 조정
    - `19`: (포인트 증가) 분배
    - `31`: (포인트 증가) 환불
    - `32`: (포인트 증가) 정액제 해지
    - `21`: (포인트 감소) 서비스 사용
    - `22`: (포인트 감소) 조정
    - `23`: (포인트 감소) 조정
    - `24`: (포인트 감소) 포인트 결제
    - `25`: (포인트 감소) 미수금 결제
    - `26`: (포인트 감소) 포인트 환불
    - `29`: (포인트 감소) 회수
    - `41`: (포인트 감소) 후불누적조정
  - txPoint `type: string` `length: 18` `description: 증감 포인트`
  - balance `type: string` `length: 18` `description: 잔여포인트`
  - txDT `type: string` `length: 14` `description: 포인트 증감 일시`
    - 형식 : yyyyMMddHHmmss
  - userID `type: string` `length: 50` `description: 담당자 아이디`
  - userName `type: string` `length: 100` `description: 담당자명`

### 예외

**PopbillException**

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

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

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

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

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

```csharp
string GetUseHistoryURL(string CorpNum, string UserID = null)
```

### 요청

**Parameters**

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

### 응답

string - 요청에 대한 응답 URL

### 예외

**PopbillException**

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

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

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

```csharp
PaymentResponse PaymentRequest(string CorpNum, PaymentForm paymentForm, string UserID = null)
```

### 요청

**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: 정산코드`

### 예외

**PopbillException**

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

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

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

```csharp
PaymentHistory GetSettleResult(string CorpNum, string settleCode, string UserID = null)
```

### 요청

**Parameters**

- CorpNum `type: string` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- SettleCode `type: string` `length: 18` `required: Y` `description: 정산코드`
  - 팝빌에서 임의 할당하는 값으로 [\[PaymentRequest - 연동회원 무통장 입금신청\]](https://developers.popbill.com/reference/kakaotalk/dotnetcore/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: int` `length: 1` `description: 결제상태`
  - `1`: 대기
  - `2`: 승인
  - `3`: 실패
  - `4`: 취소
  - `5`: 취소
- regDT `type: string` `length: 14` `description: 등록일시`
  - 형식 : yyyyMMddHHmmss
- stateDT `type: string` `length: 14` `description: 상태일시`
  - 형식 : yyyyMMddHHmmss

### 예외

**PopbillException**

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

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

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

```csharp
PaymentHistoryResult GetPaymentHistory(string CorpNum, string SDate, string EDate, int? Page, int? PerPage, string UserID = null)
```

### 요청

**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: int?` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- PerPage `type: int?` `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: int` `length: 1` `description: 결제상태`
    - `1`: 대기
    - `2`: 승인
    - `3`: 실패
    - `4`: 취소
    - `5`: 취소
  - regDT `type: string` `length: 14` `description: 등록일시`
    - 형식 : yyyyMMddHHmmss
  - stateDT `type: string` `length: 14` `description: 상태일시`
    - 형식 : yyyyMMddHHmmss

### 예외

**PopbillException**

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

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

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

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

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

```csharp
string GetPaymentURL(string CorpNum, string UserID =null)
```

### 요청

**Parameters**

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

### 응답

string - 요청에 대한 응답 URL

### 예외

**PopbillException**

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

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

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

```csharp
RefundResponse Refund(string CorpNum, RefundForm refundForm, string UserID = null)
```

### 요청

**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: 환불코드`

### 예외

**PopbillException**

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

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

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

```csharp
RefundHistoryResult GetRefundHistory(string CorpNum, int? Page = null, int? PerPage = null, string UserID = null)
```

### 요청

**Parameters**

- CorpNum `type: string` `length: 10` `required: Y` `description: 팝빌회원 사업자번호 ('-' 제외)`
- Page `type: int?` `length: -` `required: N` `description: 목록 페이지번호`
  - 기본값 : 1
- PerPage `type: int?` `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: int` `length: 1` `description: 상태`
    - `1`: 접수대기
    - `2`: 심사중
    - `3`: 입금대기
    - `4`: 환불완료
    - `5`: 취소
  - reason `type: string` `length: 200` `description: 환불사유`

### 예외

**PopbillException**

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

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

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

```csharp
RefundHistory GetRefundInfo(string CorpNum, string RefundCode, string UserID = null)
```

### 요청

**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: int` `length: 1` `description: 상태`
  - `1`: 접수대기
  - `2`: 심사중
  - `3`: 입금대기
  - `4`: 환불완료
  - `5`: 취소
- reason `type: string` `length: 200` `description: 환불사유`

### 예외

**PopbillException**

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

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

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

```csharp
double GetRefundableBalance(string CorpNum, string UserID = null)
```

### 요청

**Parameters**

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

### 응답

double - 환불 가능 포인트

### 예외

**PopbillException**

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

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

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

```csharp
double GetPartnerBalance(string CorpNum)
```

### 요청

**Parameters**

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

### 응답

double - 파트너 잔여포인트

### 예외

**PopbillException**

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

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

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

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

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

```csharp
string GetPartnerURL(string CorpNum, string TOGO)
```

### 요청

**Parameters**

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

### 응답

string - 요청에 대한 응답 URL

### 예외

**PopbillException**

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