카카오 로그인으로 배송지 조회하기

- Kakao 공식 가이드 : https://developers.kakao.com/docs/latest/ko/kakaosync/shipping

- 디벨로퍼스 REST-API 데모 : https://developers.kakao.com/tool/rest-api/open/get/v1-user-shipping_address

※ 데모 테스트를 위해서는 배송지 정보(shipping_address) 사용자 동의 항목 활성화된 디벨로퍼스앱을 선택해야합니다.

<디벨로퍼스 앱 선택>

---

사전 체크 1. 배송지 정보(shipping_address) 동의 설정 (동의항목별 필수 동의 설정 방법)

배송지 동의 항목 설정을 위해서는 현재 제공하고 있는 서비스의 일반 회원가입에서 배송지를 입력 받고 있어야 카카오 싱크 동의 항목 신청이 가능합니다.

 

카카오싱크 설정하기 : 설정하기 | Kakao Developers 문서
카카오싱크 신청 : 카카오비즈니스

---

1. 배송지 제3자 정보 제공동의 : 사용자로 부터 동의를 받아야 배송지 조회 가능합니다.

2. 디벨로퍼스 동의 설정에서 "수집" 선택 시, 로그인 중 배송지가 없다면 동의창이 표시되기 전에 배송지를 입력 받습니다. 

3. 배송지 조회 REST-API 사용 ( 공식 가이드 )

API호출 방법은 로그인한 사용자의 액세스 토큰을 이용한 조회와 ADMIN KEY를 이용한 조회가 있습니다. 

GET v1/user/shipping_address HTTP/1.1
Host: kapi.kakao.com
Authorization: Bearer ${ACCESS_TOKEN}

GET v1/user/shipping_address HTTP/1.1
Host: kapi.kakao.com
Authorization: KakaoAK ${APP_ADMIN_KEY}

---

사후 체크 1. 카카오 계정 설정 페이지에서 배송지정보 수집 동의는 사용자가 언제든 철회 가능하며, 철회 시 카카오 계정의 배송지 정보는 삭제됩니다.

 

디벨로퍼스앱을 통해 배송지 필수(수집) 설정으로 가입당시 배송지를 받았어도 카카오계정에서 철회되면 배송지는 조회되지 않으므로 

배송지가 반드시 필요한 경우,

배송지 필수(수집) 설정 되어 있다면 추가 항목 동의 받기 로 사용자에게 다시 입력 받을 수 있습니다. 

 

---

자주하는 질문

 

Q. 사용자 정보 가져오기(v2/user/me) API호출 해도 배송지가 조회안되요.

A. 배송지는 v1/user/shipping_address 로 조회 합니다.

 

Q. 배송지 필수(수집) 설정으로 동의 받았는데 배송지 조회가 안되요. 

A. 해당 유저가 카카오 계정 페이지에서 동의 철회 하여 배송지 삭제했을 수 있습니다. 위 사후 체크 1 확인해주세요.

or

A. 배송지 수집 설정을 하지 않으셔서 배송지가 없는 사용자는 조회 안되었습니다. "수집" 설정을 해주세요.