080 수신거부 가이드

핑거푸시 080수신거부 서비스 이용 시 사용자의 데이터를 고객사와 연동하는 방법을 설명합니다.

용어 정의

• 사용자 : 수신거부를 요청하는 일반 사용자

• 공급사 : 핑거푸시 서비스

• 고객사 : 핑거푸시 080서비스에 가입한 법인

서비스 종류

종류	예시	수신거부 절차
일반형	(광고)안녕하세요 핑거푸시 입니다. ….. 내 용 … ….. 내 용 … 무료수신거부 080-XXX-XXXX	1. 문자 메시지 수신 2. 무료수신거부 번호로 전화 3. ARS 안내에 따라 전화번호 입력 4. 수신거부 완료
상점형	(광고)안녕하세요 핑거푸시 입니다. ….. 내 용 … ….. 내 용 … 무료수신거부 080-XXX-XXXX 상점코드 XX	1. 문자 메시지 수신 2. 무료수신거부 번호로 전화 3. ARS 안내에 따라 상점코드 입력 4. 수신거부 완료

서비스 신청 방법

① 핑거푸시 서비스 가입

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

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

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

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

서버 정보

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

② IP: 14.63.169.244

API 요청 방식

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

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

API 응답 방식

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

고객사 연동 흐름도

수신거부 고객사 연동 방식

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

② 고객사 -> 핑거푸시: 결과 처리 후 화면에 결과를 출력합니다.(json형식)

일반형 수신거부

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

파라미터	형태	길이	필수값	설명
uNumber	String	11	0	수신거부 번호(080-XXX-XXXX) ( - 제외한 숫자만 전달)
rNumber	String	11	0	수신거부 요청 번호(010-XXXX-XXXX) ( - 제외한 숫자만 전달) 예)고객의 핸드폰 번호

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

항목	경우의 수	출력 형식	필수값
수신거부 성공	고객번호 최초 입력	{ “code”:200, "tment_result”:” 수신거부가 정상 처리되었습니다” }	code: 결과 코드 tment_result: 결과 메시지
수신거부 성공	고객번호가 존재하는 경우	{ “code”:201, "tment_result”: 이미 등록된 번호입니다” }	code: 결과 코드tment_result: 결과 메시지
수신거부 실패	200, 201 외의 경우 401로 코드 지정	{ “code”:401, "tment_result”: 수신거부가 실패 처리되었습니다”, “msg”:”실패사유” }	code: 결과 코드 tment_result: 결과 메시지 msg(옵션): 실패 사유

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

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

회사명 수신거부일 {tment_result} 키스소프트 20230120 {수신거부가 정상 처리 되었습니다.}

상점형 수신거부

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

파라미터	형태	길이	필수값	설명
uNumber	String	11	0	수신거부 번호(080-XXX-XXXX) ( - 제외한 숫자만 전달)
rNumber	String	11	0	수신거부 요청 번호(010-XXXX-XXXX) ( - 제외한 숫자만 전달) 예)고객의 핸드폰 번호
sCode	String	6	0	상점 코드는 고객사에서 관리하는 영역으로 sCode 값이 고객사에 존재하는 상점 코드인지 검증해야 합니다.

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

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

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

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

{tment_sname} {tment_date} {tment_result} {키스소프트} {20230120} {수신거부가 정상 처리 되었습니다.}