> For the complete documentation index, see [llms.txt](https://developers.fingerpush.com/assemble/llms.txt). Markdown versions of documentation pages are available by appending `.md` to page URLs; this page is available as [Markdown](https://developers.fingerpush.com/assemble/guide/080.md).

# 080 수신거부 가이드

{% hint style="info" %}
핑거푸시 080수신거부 서비스 이용 시 사용자의 데이터를 고객사와 연동하는 방법을 설명합니다.
{% endhint %}

## 용어 정의

* 사용자 : 수신거부를 요청하는 일반 사용자
* 공급사 : 핑거푸시 서비스
* 고객사 : 핑거푸시 080서비스에 가입한 법인

## 서비스 종류

<table data-full-width="false"><thead><tr><th width="128">종류</th><th>예시</th><th>수신거부 절차</th></tr></thead><tbody><tr><td>일반형</td><td><p>(광고)안녕하세요 핑거푸시 입니다.</p><p>….. 내  용 …</p><p>….. 내  용 …</p><p>무료수신거부 080-XXX-XXXX</p></td><td><p>1. 문자 메시지 수신</p><p>2. 무료수신거부 번호로 전화</p><p>3. ARS 안내에 따라 전화번호 입력</p><p>4. 수신거부 완료</p></td></tr><tr><td>상점형</td><td><p>(광고)안녕하세요 핑거푸시 입니다.</p><p>….. 내  용 …</p><p>….. 내  용 …</p><p>무료수신거부 080-XXX-XXXX</p><p>상점코드 XX</p></td><td><p>1. 문자 메시지 수신</p><p>2. 무료수신거부 번호로 전화</p><p>3. ARS 안내에 따라 상점코드 입력</p><p>4. 수신거부 완료</p></td></tr></tbody></table>

## 서비스 신청 방법

①    핑거푸시 서비스 가입

②    고객센터 Q\&A를 통해 080 수신거부 서비스 가입 방법 문의

③    080 수신거부 서비스 가입 서류 수령, 작성 후 제출

④    080 수신거부 서비스 개통(080 번호와 연동 매뉴얼 전달)

⑤    수신거부 고객사 연동 개발

## 서버 정보

①    핑거푸시 서비스의 IP를 고객사의 outbound 방화벽 정책에 추가해야 합니다.

②    IP: 14.63.169.244

## API 요청 방식

①    모든 API는 HTTP 프로토콜을 기반으로 합니다.

②    수신거부 데이터 전달은 POST 방식으로 전달합니다.

③    인코딩 방식은 EUC-KR을 사용합니다.

## API 응답 방식

고객사는 핑거푸시 서비스로부터 POST로 파라미터를 전달 받은 결과를 정해진 형식에 따라 화면에 출력합니다.

## 고객사 연동 흐름도

<figure><img src="/files/HN9miTbJKbwLK2Wm1W6R" alt=""><figcaption></figcaption></figure>

## 수신거부 고객사 연동 방식

①    핑거푸시 -> 고객사: HTTP POST 방식을 통해 고객사로 수신거부 데이터를 전달합니다.

②    고객사 -> 핑거푸시: 결과 처리 후 화면에 결과를 출력합니다.(json형식, euc-kr 인코딩만 지원)

## 일반형 수신거부

#### 1) 일반형 고객사 전달 파라미터

<table data-full-width="false"><thead><tr><th width="143">파라미터</th><th width="103">형태</th><th width="94" data-type="number">길이</th><th width="98" data-type="number">필수값</th><th>설명</th></tr></thead><tbody><tr><td>uNumber</td><td>String</td><td>11</td><td>0</td><td><p>수신거부 번호(080-XXX-XXXX)</p><p>( - 제외한 숫자만 전달)</p></td></tr><tr><td>rNumber</td><td>String</td><td>11</td><td>0</td><td><p>수신거부 요청 번호(010-XXXX-XXXX)</p><p>( - 제외한 숫자만 전달)</p><p>예)고객의 핸드폰 번호</p></td></tr></tbody></table>

#### 2) 일반형 고객사 응답 처리

<table data-full-width="false"><thead><tr><th width="147">항목</th><th width="180">경우의 수</th><th width="236">출력 형식</th><th>필수값</th></tr></thead><tbody><tr><td>수신거부 성공</td><td>고객번호 최초 입력 </td><td><p>{   </p><p>“code”:200,</p><p>"tment_result”:” 수신거부가 정상 처리되었습니다”</p><p>}</p></td><td>code: 결과 코드 tment_result: 결과 메시지</td></tr><tr><td>수신거부 성공</td><td>고객번호가 존재하는 경우</td><td><p>{   </p><p>“code”:201,</p><p>"tment_result”: 이미 등록된 번호입니다”</p><p>}</p></td><td>code: 결과 코드tment_result: 결과 메시지</td></tr><tr><td><p>수신거부</p><p>실패</p></td><td><p>200, 201 외의 경우 </p><p>401로 코드 지정</p></td><td><p>{   </p><p>“code”:401,</p><p>"tment_result”: 수신거부가 실패 처리되었습니다”,</p><p>“msg”:”실패사유”</p><p>}</p></td><td><p>code: 결과 코드 tment_result: 결과 메시지</p><p>msg(옵션): 실패 사유</p></td></tr></tbody></table>

#### 3) 일반형  고객사 결과 메시지 실행

상점 이름(신청 시 회사명), 수신거부일, 결과 메시지의 3가지로 구성됩니다.&#x20;

{% hint style="info" %} <mark style="color:blue;">회사명 수신거부일 {tment\_result}</mark>\
키스소프트 20230120 {수신거부가 정상 처리 되었습니다.}&#x20;
{% endhint %}

## 상점형 수신거부

#### 1) 상점형 고객사 전달 파라미터

<table data-full-width="false"><thead><tr><th width="143">파라미터</th><th width="103">형태</th><th width="94" data-type="number">길이</th><th width="84" data-type="number">필수값</th><th>설명</th></tr></thead><tbody><tr><td>uNumber</td><td>String</td><td>11</td><td>0</td><td><p>수신거부 번호(080-XXX-XXXX)</p><p>( - 제외한 숫자만 전달)</p></td></tr><tr><td>rNumber</td><td>String</td><td>11</td><td>0</td><td><p>수신거부 요청 번호(010-XXXX-XXXX)</p><p>( - 제외한 숫자만 전달)</p><p>예)고객의 핸드폰 번호</p></td></tr><tr><td>sCode</td><td>String</td><td>6</td><td>0</td><td><p>상점 코드는 고객사에서 관리하는 영역으로</p><p>sCode 값이 고객사에 존재하는 상점 코드인지 검증해야 합니다.</p></td></tr></tbody></table>

#### 2) 상점형 고객사 응답 처리

<table data-full-width="false"><thead><tr><th width="120">항목</th><th width="171">경우의 수</th><th width="237">출력 형식</th><th>필수값</th></tr></thead><tbody><tr><td>수신거부 성공</td><td>고객번호 최초 입력 </td><td><p>{   </p><p>“code”:200,</p><p>“tment_sname”:”상점 이름”,</p><p>“tment_date”:”연월일”,</p><p>“tment_result”:” 수신거부가 정상 처리되었습니다”</p><p>}</p></td><td><p>code: 결과 코드</p><p>tment_sname: 상점 이름</p><p>tment_date(옵션): 등록일</p><p>tment_result: 결과 메시지</p></td></tr><tr><td>수신거부 성공</td><td>고객번호가 존재하는 경우</td><td><p>{   </p><p>“code”:201,</p><p>“tment_sname”:”상점 이름”,</p><p>“tment_date”:”연월일”,</p><p>“tment_result”: 이미 등록된 번호입니다”</p><p>}</p></td><td><p>code: 결과 코드</p><p>tment_sname: 상점 이름</p><p>tment_date(옵션): 등록일</p><p>tment_result: 결과 메시지</p></td></tr><tr><td><p>수신거부</p><p>실패</p></td><td>상점코드 불일치</td><td><p>{   </p><p>“code”:402,</p><p>“tment_sname”:”상점 이름”,</p><p>“tment_date”:”연월일”,</p><p>“tment_result”: 상점 코드가 맞지 않아, 수신거부가 실패 처리 되었습니다”</p><p>}</p></td><td><p>code: 결과 코드</p><p>tment_sname: 상점 이름</p><p>tment_date(옵션): 등록일</p><p>tment_result: 결과 메시지</p></td></tr><tr><td><p>수신거부</p><p>실패</p></td><td><p>200, 201 외의 경우 </p><p>401로 코드 지정</p></td><td><p>{   </p><p>“code”:401,</p><p>“tment_sname”:”상점 이름”,</p><p>“tment_date”:” 연월일”,</p><p>“tment_result”: 수신거부가 실패 처리되었습니다”,</p><p>“msg”:”실패 사유”</p><p>}</p></td><td><p>code: 결과 코드</p><p>tment_sname: 상점 이름</p><p>tment_date(옵션): 등록일</p><p>tment_result: 결과 메시지</p><p>msg(옵션): 실패 사유</p></td></tr></tbody></table>

#### 3) 상점형  고객사 결과 메시지 실행

상점 이름(회사명), 수신거부일, 결과 메시지의 3가지로 구성됩니다.&#x20;

{% hint style="info" %} <mark style="color:blue;">{tment\_sname} {tment\_date} {tment\_result}</mark>\
{키스소프트} {20230120} {수신거부가 정상 처리 되었습니다.}&#x20;
{% endhint %}