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형식, euc-kr 인코딩만 지원)
일반형 수신거부
1) 일반형 고객사 전달 파라미터
uNumber
String
수신거부 번호(080-XXX-XXXX)
( - 제외한 숫자만 전달)
rNumber
String
수신거부 요청 번호(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
수신거부 번호(080-XXX-XXXX)
( - 제외한 숫자만 전달)
rNumber
String
수신거부 요청 번호(010-XXXX-XXXX)
( - 제외한 숫자만 전달)
예)고객의 핸드폰 번호
sCode
String
상점 코드는 고객사에서 관리하는 영역으로
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} {수신거부가 정상 처리 되었습니다.}
Last updated
