[프리미엄] 외부 회원 연동 가이드
Last updated
Last updated
일부 API는 2024년 11월 6일(수) 업데이트 되었습니다. [공지보기]
아래 가이드를 통해, 고객사에서 기존에 보유하고 있던 회원정보를 이용하여 샵바이 쇼핑몰에서 로그인 가능합니다. 쇼핑몰 회원 인증/ 휴면회원 해제/ 회원 탈퇴 연동을 진행해보세요.
※ 외부 회원 연동은 토큰 기반 연동 방식을 제공합니다.
※ 외부 회원 연동 시 쇼핑몰회원(간편 로그인 포함) 가입은 불가합니다.
오로라 기본 스킨에서는 인증 관리를 쉽게 할 수 있는 유틸리티를 제공합니다. 자세한 내용은 인증관리 유틸리티 사용법(외부 회원 연동) 가이드를 참고하세요.
▶ 외부아이디 로그인 토큰으로 샵바이 토큰 획득 API 바로가기
외부아이디(오픈아이디 포함) 로그인을 통한 샵바이 토큰 획득 API에 대한 안내 입니다.
https://docs.shopby.co.kr/?url.primaryName=auth/#/Authentication/post-oauth-openid API 를 이용하여 고객사의 토큰을 이용해 샵바이 토큰을 발급받을 수 있습니다.
해당 API 요청 시 아래의 값은 필수값으로 전송해야 합니다.
provider : ncpstore
openAccessToken : 외부입점사에서 발급한 accessToken
고객사에서는 샵바이의 스팩에 맞는 request param과 response 에 맞는 API를 제공해야 합니다.
예시) GET https://abc.com/id?token=myToken
요청의 형태는 위 URI 와 같으며 queryParam 으로 token 이라는 파라메터에 고객사 로그인 토큰 값을 전달합니다. URI는 각 고객사에 맞게 수정 가능합니다.
로그인 토큰을 Header에 Authorization 필드로도 전달합니다. 아래 두 가지 형태 모두 지원합니다.
타입 포함 - Authorization : {type} {token} ex) Authorization : Bearer abc123
타입 미포함 - Authorization : {token} ex) Authorization : abc123
(1) 유효한 토큰인 경우
유효한 토큰이면 성공(200)으로 응답
HTTP Status 200 OK
| 항목 | 타입 | 필수여부 | 제한 | Null인 경우 | 설명 |
|---|---|---|---|---|---|
id | String | O | 최대 50자 | Null 불가 | 업체에서 관리하는 회원의 유일값 (전화번호 등 변동가능한 값 사용이 어렵습니다) |
name | String | X | 최대 50자 | 기존 저장값 유지 | 사용자 이름 |
adultCertified | Boolean | X |
| 기존 저장값 유지 | 성인 인증 여부 |
gradeNo | Number | X | 기존 저장값 유지 | 회원 등급 (사전에 등록 필요) | |
groupNos | Array | X | 기존 저장값 유지 | 회원 그룹 (사전에 등록 필요) | |
nickname | String | X | 최대 30자 | 기존 저장값 유지 | 사용자 별명, 별칭 |
String | X | 최대 50자 | 기존 저장값 유지 | 이메일 | |
phone | String | X | 숫자만 (- 제거 필수) | 기존 저장값 유지 | 휴대전화번호 |
nation | String | X | 기존 저장값 유지 | KR, US, JP, CN / 기본값은 쇼핑몰 설정을 따름 | |
privacyPolicyAgreed | Boolean | X | 기존 저장값 유지 | 본인인증여부 | |
pushPolicyAgreed | Boolean | X | 기존 저장값 유지 | 앱푸시동의 여부 - 샵바이에서 사용하지 않음 | |
smsPolicyAgreed | Boolean | X | 기존 저장값 유지 | 광고성sms 수신동의 여부 | |
emailPolicyAgreed | Boolean | X | 기존 저장값 유지 | 광고성email 수신동의 여부 | |
gender | String | X | 기존 저장값 유지 | 성별 | |
ci | String | X | 기존 저장값 유지 | ci | |
birthday | String | X | 'yyyyMMdd' 형식 | 기존 저장값 유지 | 생년월일 |
businessName | String | X | 기존 저장값 유지 | 사업자명 | |
businessRegistrationNumber | String | X | 기존 저장값 유지 | 사업자등록번호 | |
extraJson | String | X | JSON String | 기존 저장값 유지 | 추가 정보 (입점사 회원 커스텀 정보) |
샵바이 관리자에서 회원등급과 회원그룹을 설정 후 NHN커머스 측으로 요청 시 groupNos 값을 전달해 드립니다.
extraJson 항목에, 고객사에서 추가적으로 저장하고 싶은 회원정보를 JsonString형태로 샵바이에 전달가능합니다. 이렇게 전달된 extraJson정보는 회원정보 조회하기 shop API와 server API에서 응답값 내 additionalInfo로 바이패스되어 전달됩니다.
businessName과 businessRegistrationNumber 2개 모두 값이 있어야 최초 등록 가능합니다. 2개 항목 모두 ""(empty)로 보내면 기존 등록된 내용이 삭제됩니다.
고객(회원)이 설정한 서비스에 대한 마케팅 동의 여부 등을 위 API의 응답으로 보내주시면 쇼핑몰에 진입할 때마다
회원 정보를 응답 값으로 매번 변경합니다.
샵바이 토큰 발행 api (https://docs.shopby.co.kr/?url.primaryName=auth/#/Authentication/post-oauth-openid ) 의 응답으로 유효하지 않은 토큰이면 권한없음(401)로 응답합니다.
HTTP Status 401 Unauthorized
쇼핑몰 화면에서는 401 응답일 경우, 제휴사의 로그인 인증을 다시 획득하기 위한 화면으로 이동하면 됩니다.
또한 토큰발행 api 가 아닌 다른 api 호출 시 샵바이 토큰의 만료로 401 Unauthorized가 발생하는 경우 제휴사의 토큰을 이용하셔 샵바이 토큰을 재발행 하면 됩니다.
나머지 고객사 API 측 오류면 고객사에서 내려준 response 를 그대로 message 에 포함하여 오류(400)로 응답합니다.
앱에서 회원탈퇴할 경우, server api의 회원 탈퇴 API (https://server-docs.shopby.co.kr/?url.primaryName=member/#/Profile/delete-profile) 호출을 반드시 해주세요.
앱에서 휴면처리될 경우, server api의 휴면처리 API (https://server-docs.shopby.co.kr/?url.primaryName=member/#/Profile/put-profile-dormant) 호출을 반드시 해주세요.
외부 회원 연동을 사용하시면서 동시에 샵바이에서 제공하는 회원 등급 평가를 사용하시고 싶으실 경우, 회원등급(gradeNo) 값을 null 로 보내면 기존에 저장된 값을 업데이트 하지 않고 그대로 유지하므로 샵바이에서 제공하는 회원등급을 사용하실 수 있습니다.
외부 연동 회원 데이터로 동기화 하고 싶으실 경우,
샵바이 관리자 내 '회원 등급 관리' 메뉴에서 [등급 평가 설정] 버튼을 클릭하시어 자동 등급 평가 사용을 '사용 안 함' 처리해주세요.
연동 데이터 전달 시에는 회원등급(gradeNo) 값을 해당 쇼핑몰의 groupNo로 전달해 주세요. * 위 경우에는 샵바이에서 등급 평가를 '사용함'으로 설정 하더라도 해당 회원이 쇼핑몰에 로그인하는 시점에 외부 연동 회원 데이터로 동기화 되므로 유의바랍니다.
