이 문서는 카카오싱크 도입, 설정, 연동, 운영 중 자주 묻는 질문과 문제 해결 방법을 제공합니다.

카카오싱크 연동 중 오류가 발생하거나 기대한 동의 화면, 사용자 정보, 채널 추가 항목이 표시되지 않는다면 아래 항목부터 확인합니다.

문제가 계속되면 아래 정보를 함께 확인해 데브톡으로 문의합니다.

• 앱 ID
• 사용 중인 플랫폼 또는 호스팅사
• 서비스 URL
• 발생한 에러 코드와 전체 에러 메시지
• 실제 요청에 사용한 앱 키와 redirect_uri
• 사용자 정보 조회 API 응답 중 문제가 되는 필드
• 문제가 발생한 사용자의 앱 유저 ID (서비스 회원번호)
• 비즈 앱과 연결하려는 카카오톡 채널의 검색용 ID

KOE006은 리다이렉트 URI 설정이 올바르지 않거나, 앱에 등록하지 않은 redirect_uri 값으로 인가 코드를 요청할 때 발생합니다.

아래 순서로 확인합니다.

1. 에러 화면이나 실제 요청 로그에 표시된 redirect_uri 값을 확인합니다.
2. 앱 관리 페이지의 [앱] > [플랫폼 키] > [REST API 키] 또는 [Javascript 키] > [카카오 로그인 리다이렉트 URI]에 같은 URI가 등록되어 있는지 확인합니다. (참고: 리다이렉트 URI)
3. 프로토콜, 도메인, 포트, 경로, 마지막 슬래시(/)까지 완전히 일치하는지 확인합니다.
4. JavaScript SDK와 REST API를 함께 사용하는 경우, JavaScript 키와 REST API 키에 각각 리다이렉트 URI가 등록되어 있는지 확인합니다. [앱] > [플랫폼 키] > [REST API 키] 또는 [JavaScript 키]에서 [수정]을 눌러 리다이렉트 URI를 확인 및 수정할 수 있습니다.

실제 요청에 사용된 redirect_uri는 오류 화면과, 오류 지속시 발송되는 이메일 및 알림, 서비스 요청 로그에서도 확인할 수 있습니다.

호스팅사를 사용하는 경우, 서비스에서 직접 입력한 콜백 URL이 아니라 호스팅사에서 사용하는 실제 콜백 URL이 요청될 수 있으므로 호스팅사 관리자 화면도 함께 확인해야 합니다.

대표적인 호스팅사 콜백 URI 형식은 아래와 같습니다. 실제 서비스 도메인과 호스팅사 설정에 맞게 등록해야 합니다. 카페24, 고도몰 등 호스팅사를 통해 카카오싱크를 사용하는 경우 PC, 모바일, HTTP, HTTPS 도메인별 콜백 URI가 다를 수 있습니다.

자세한 에러 설명은 데브톡 KOE006 FAQ를 참고합니다.

KOE010 또는 Bad client credentials는 주로 토큰 요청 시 클라이언트 인증 정보가 올바르지 않을 때 발생합니다.

아래 순서로 확인합니다.

1. 앱 관리 페이지의 [앱] > [플랫폼 키] > [REST API 키]에서 클라이언트 시크릿 사용 여부를 확인합니다.
2. 클라이언트 시크릿을 사용 중이라면 토큰 요청 API에 client_secret 파라미터를 포함했는지 확인합니다.
3. 요청에 포함한 client_secret 값이 현재 앱에 발급된 값과 일치하는지 확인합니다.
4. 토큰 요청의 Content-Type이 application/x-www-form-urlencoded인지 확인합니다.
5. 토큰 요청이 POST 방식인지 확인합니다. JSON 문자열이나 multipart/form-data 형식으로 요청하지 않습니다.

카페24 등 호스팅사 간편설정을 사용하는 경우 클라이언트 시크릿을 지원하지 않을 수 있습니다. 호스팅사에서 KOE010이나 Bad client credentials 오류가 발생하면 클라이언트 시크릿을 [사용 안 함]으로 변경하거나 삭제한 뒤 다시 확인합니다.

[필수 동의]로 설정한 동의항목이라도 사용자 정보 조회 응답에 값이 없을 수 있습니다. [필수 동의]는 사용자가 해당 항목 제공에 동의해야 가입을 계속할 수 있다는 의미이며, 카카오계정에 없는 값을 카카오가 생성해 제공한다는 의미는 아닙니다.

아래 순서로 확인합니다.

1. 사용자 정보 조회 API 응답에서 필요한 필드와 ${FIELD_NAME}_needs_agreement 값을 확인합니다.
2. 사용자의 카카오계정에 해당 정보가 있는지 확인합니다.
3. 해당 동의항목이 카카오계정으로 수집 후 제공을 지원하는지 확인합니다.
4. 앱에 동의항목 권한이 없거나 필요한 동의 단계로 설정할 수 없다면 개인정보 동의항목 추가 기능을 신청합니다.
5. 카카오에서 제공받을 수 없는 정보라면 서비스에서 직접 입력, 자체 인증, 가입 중단 안내 중 하나로 처리합니다.

전화번호는 카카오톡에 연결되지 않은 카카오계정에는 제공할 수 없고, 카카오계정으로 수집 후 제공도 지원하지 않습니다. 이름 또는 CI가 필요한 경우 사용자가 본인확인을 완료한 계정인지 확인해야 합니다.

이메일이 응답에 없으면 아래 내용을 추가로 확인합니다.

• 사용자 정보 조회 응답의 email_needs_agreement 값이 true이면 동의항목 추가 동의 요청으로 이메일 제공 동의를 다시 요청합니다.
• 기존 사용자가 이메일 동의항목 설정 전에 로그인했다면 기존 토큰에는 이메일 제공 권한이 없을 수 있습니다. 사용자의 재로그인 또는 추가 동의를 유도합니다.
• 이메일을 로그인 시 필수로 받으려면 비즈 앱 전환과 동의항목 설정 권한이 필요할 수 있습니다.

서비스 약관 선택해 동의 요청 API를 호출했는데 동의 화면이 표시되지 않으면 아래 두 조건을 확인합니다.

• 요청한 서비스 약관이 간편가입 설정에서 [필수 동의]로 등록되어 있어야 합니다.
• 사용자가 해당 서비스 약관에 아직 동의하지 않은 상태여야 합니다.

이미 동의한 약관이나 선택 동의 약관만 요청하면 동의 화면이 표시되지 않습니다. 사용자의 약관 동의 상태는 서비스 약관 동의 내역 조회 API로 확인합니다.

카카오싱크 동의 화면에 카카오톡 채널 추가 항목이 표시되지 않으면 아래 내용을 확인합니다.

• 앱에 카카오톡 채널이 연결되어 있는지 확인합니다.
• 대표 채널이 설정되어 있는지 확인합니다.
• 사용자가 이미 해당 채널을 친구로 추가했는지 확인합니다.
• 사용자가 카카오톡에 연결되지 않은 카카오계정으로 로그인했는지 확인합니다.
• 채널 친구 상태를 서비스에서 확인해야 한다면 카카오톡 채널 관계 조회 API를 사용합니다.

채널 추가 항목은 사용자가 선택할 수 있는 항목입니다. 채널 친구 추가를 서비스 가입 조건으로 운영해야 한다면 서비스 정책에 맞는 별도 안내와 동선을 마련해야 합니다.

사용자가 카카오싱크 간편가입을 완료했더라도 서비스 데이터베이스에 회원으로 등록되지 않았다면 서비스 가입은 완료되지 않습니다.

아래 흐름이 구현되어 있는지 확인합니다.

1. 인가 코드로 토큰을 발급합니다.
2. 액세스 토큰으로 사용자 정보 조회 API를 호출합니다.
3. 서비스 약관 동의 내역 조회 API로 필수 약관 동의 상태를 확인합니다.
4. 서비스 데이터베이스에서 기존 회원 여부를 확인합니다.
5. 신규 회원이면 회원을 생성합니다. 기존 카카오 로그인 사용자나 기존 서비스 회원이 있다면 중복 가입을 방지하기 위해 기존 회원 확인과 연결을 먼저 설계합니다.
6. 서비스 세션을 발급해 로그인 처리를 완료합니다.

자세한 구현 절차는 카카오싱크 연동 과정을 참고합니다.

카카오싱크 서비스에서 사용자가 회원 탈퇴해도 서비스와 앱의 연결을 해제하지 않으면 카카오계정의 연결된 서비스 관리에 서비스가 계속 표시될 수 있습니다.

회원 탈퇴 시 아래 두 가지를 모두 처리합니다.

• 서비스 데이터베이스에서 사용자 정보를 삭제하거나 서비스 약관 및 개인정보 처리방침에 따른 조치를 수행합니다.
• 연결 해제 API를 호출해 앱과 사용자의 연결을 끊습니다.

사용자가 카카오계정의 연결된 서비스 관리에서 먼저 연결 해제한 경우를 처리하려면 연결 해제 웹훅을 설정합니다.

카카오 비즈니스 파트너센터에서 채널의 마스터 혹은 매니저 계정으로 로그인한 후 설정할 수 있습니다.

자세한 설정 방법은 카카오비즈니스 가이드를 참고합니다.

앱 관리 페이지의 [앱] > [카카오톡 채널] > [대표 채널]에서 원하는 채널을 대표 채널로 변경합니다.

대표 채널은 앱과 연결된 비즈니스 채널 중 선택할 수 있습니다.

앱과 채널은 아래 조건을 모두 만족해야 연결할 수 있습니다. 조건을 만족하지 않으면 연결 가능한 채널 목록에 표시되지 않습니다.

• 채널이 비즈니스 채널 심사를 통과해야 합니다. 심사를 통과하지 않았다면 카카오톡 채널 파트너센터에서 비즈니스 채널 전환을 신청합니다.
• 비즈 앱에 저장된 사업자등록번호와 비즈니스 채널에 저장된 사업자등록번호가 일치해야 합니다.
  • 비즈니스 채널에 사업자등록번호가 저장되어 있지 않다면 카카오톡 채널 파트너센터에서 사업자 정보를 등록합니다.
  • 사업자 정보를 변경하려면 카카오비즈니스의 [비즈니스 설정] > [사업자 정보 관리]에서 변경합니다.
• 앱과 채널 모두 관리자 권한이 있어야 합니다.
  • 비즈 앱을 소유한 카카오계정은 에디터(Editor) 또는 오너(Owner) 권한이 있어야 합니다.
  • 비즈니스 채널을 소유한 카카오계정은 마스터 또는 매니저 권한이 있어야 합니다.
• 비즈니스 채널은 하나의 비즈 앱에만 연결할 수 있으므로, 다른 앱에 이미 연결된 채널은 표시되지 않습니다. 연결하고자 하는 비즈니스 채널이 다른 앱과 연결된 상태가 아닌지 확인합니다.
  • 앱과 채널 연결 방법은 앱에 카카오톡 채널 연결을 참고합니다.
• 비즈니스 채널이 휴면, 제재, 삭제 대기 상태인 경우 연결할 수 없습니다.

카카오톡 채널 추가 항목은 사용자가 선택할 수 있는 동의항목입니다. 서비스에서 채널 추가를 필수 가입 조건으로 운영하려면, 카카오싱크 동의 화면만으로 강제하지 말고 서비스 정책에 맞는 별도 안내와 가입 동선을 마련해야 합니다.

채널 추가 동의 화면이 보이지 않거나 실제 채널 친구 상태가 기대와 다르다면 채널 추가 항목을 먼저 확인합니다. 사용자의 실제 채널 친구 상태를 서비스에서 확인해야 한다면 카카오톡 채널 관계 조회 API를 사용합니다.

카카오싱크를 이용 중인 사업자 번호(혹은 고유 번호)가 국세청 조회 시 폐업자(휴업자)로 확인되거나, 비즈니스 채널 신청이 불가능한 업종에 해당할 경우 카카오톡 채널이 일반 채널로 전환될 수 있습니다. 이 경우 카카오톡 채널 파트너센터에서 비즈니스 채널 재심사 요청을 할 수 있으며, 승인 이전까지는 제한된 동의항목만 설정할 수 있습니다.

비즈니스 채널 신청을 참고합니다. 이 외 추가 문의는 카카오싱크 고객센터로 문의합니다.

아닙니다. 간편가입 적용 후 서비스가 필수 동의항목 또는 서비스 약관에 대한 동의를 필요로 하는 경우에만 로그인 과정에서 간편가입 동의 화면 또는 추가 동의 화면이 표시될 수 있습니다.

이미 필요한 동의항목과 서비스 약관에 모두 동의한 사용자는 동의 화면이 다시 표시되지 않을 수 있습니다.

카카오계정에 이메일, 이름 등 특정 정보가 없다는 이유만으로 간편가입 동의 화면이 항상 표시되는 것은 아닙니다.

즉, 추가 동의 화면 표시 여부는 서비스가 요청한 동의항목, 사용자의 기존 동의 상태, 서비스 약관 설정 등에 따라 달라질 수 있습니다.

아닙니다. 카카오는 서비스 데이터에 접근하지 않습니다. 카카오는 서비스로부터 API 요청을 받고, 이에 따라 정보를 제공하거나 플랫폼 내부 처리를 수행할 뿐입니다.

네. 테스트 앱으로 운영 중인 서비스에 영향을 주지 않고 테스트할 수 있습니다. 테스트 앱 사용 방법은 테스트 앱을 참고합니다.

아닙니다. 이미 카카오 로그인을 연동한 비즈 앱이 있다면 새 앱을 만들지 말고 서비스에서 사용 중인 기존 앱으로 카카오싱크를 도입해야 합니다.

앱마다 앱 키와 권한, 사용자 식별자가 다르기 때문에 새 앱으로 카카오싱크를 도입하면 기존 카카오 로그인 사용자가 다시 로그인하거나 가입해야 하고, 다른 회원번호가 발급됩니다. 이 경우 기존 카카오 로그인으로 가입한 고객을 앱 유저 ID로 식별하기 어려워집니다.

아닙니다. 기존에 사용하던 앱에 카카오싱크에 적용해도 기존 기능에는 영향이 없습니다. 카카오 로그인, 지도, 카카오톡 공유 등 기존에 사용하던 기능을 계속 사용할 수 있습니다.

디벨로퍼스 앱과 카카오톡 채널을 연결하려면 비즈 앱에 저장된 사업자등록번호와 비즈니스 채널에 저장된 사업자등록번호가 일치해야 합니다.

사업자 정보는 카카오비즈니스의 [비즈니스 설정] > [사업자 정보 관리]에서 변경할 수 있습니다. 변경에 어려움이 있다면 카카오싱크 고객센터로 문의합니다.

사업자 정보를 변경하더라도 기존에 사용하던 카카오 로그인, 지도, 카카오톡 공유 등 기능에는 영향이 없습니다.

• 기존 연결되어 있던 앱으로 로그인하던 사용자는 앱 변경 시, 로그인을 할수 없습니다. 앱 변경 시, 회원번호가 변경되어 신규 가입 처리 됩니다.
• 기존 연결되어 있던 앱에서 사용하던 비즈 플러그인은 사용할 수 없습니다.
• 챗봇을 사용하고 있었다면, 앱을 이용한 기능이 있는지 점검해봐야합니다.
• 앱을 변경해도 채널의 친구에는 영향이 없습니다.

서비스에서 제공받는 카카오계정 사용자 정보 중 기존 회원 정보에서 동일 사용자를 찾아낼 단서로 사용할 수 있는 항목을 확인합니다. 보통 이메일이나 전화번호를 사용하지만, 사용자가 언제든 변경할 수 있으므로 식별자로 적합하지 않을 수 있습니다.

이러한 경우 카카오 플랫폼에서 제공하는 사용자 식별 정보인 회원번호 사용을 권장합니다. 사용자의 카카오계정이 서비스에 연결될 때 고유한 숫자 값인 회원번호가 발급되며, 이 값은 동일 사용자가 탈퇴하고 재가입하더라도 변경되지 않습니다. 단, 2018년 9월 19일 이전 생성 앱에서 [사용자 아이디 고정]을 사용하지 않는 경우에는 연결 해제 후 재연결 시 회원번호가 변경될 수 있습니다.

서비스마다 회원 체계, 사용자 동선, 정책이 다르므로 카카오에서 구체적인 처리 방법을 안내하기는 어렵습니다. 다만 사용자가 혼란스러워하지 않도록 기존 회원과 카카오싱크 사용자를 매핑하는 규칙과 정책을 만들어야 합니다. 자세한 내용은 기존 회원 연동을 참고합니다.

카카오싱크 적용 전에 카카오 로그인으로 가입한 사용자는 신규 회원으로 가입시키지 않고 기존 회원으로 처리하는 것을 권장합니다. 자세한 내용은 기존 회원 연동을 참고합니다.

카카오싱크는 카카오 로그인의 확장 기능이며, 동일한 카카오계정으로 로그인한 경우 앱의 회원번호는 변경되지 않습니다. 사용자 정보 조회 API 응답의 회원번호(id)를 기준으로 기존 회원 여부를 확인한 후, 기존 회원과 일치하면 신규 회원을 생성하지 않고 기존 회원으로 로그인 처리합니다. 이때, 서비스는 카카오싱크를 통해 새로 제공받은 사용자 정보와 서비스 약관 동의 내역을 기존 회원 정보에 반영할 수 있습니다.

이메일, 이름처럼 가입에 필요한 정보가 카카오계정에 없는 사용자를 카카오 동선에서 입력하도록 하려면 해당 동의항목이 카카오계정으로 수집 후 제공을 지원하는지 확인하고 설정합니다. 이 경우, 서비스는 기존에 보유한 회원 정보를 사용하거나 서비스 정책에 따라 추가 입력을 요청할 수 있습니다.

카카오싱크 적용 이전에 카카오 로그인으로 가입한 사용자가 서비스 가입 과정에서 이메일이나 이름을 이미 입력했다면, 서비스는 기존 회원 정보와 회원번호(id)를 기준으로 동일 사용자인지 확인하여 로그인 처리를 이어나갑니다.

아닙니다. 카카오싱크 간편가입을 사용하면 사용자가 여러 회원 가입 페이지를 거치지 않고 쉽게 가입할 수 있습니다. 하지만 서비스 상황에 따라 서비스 약관이나 사용자 정보를 추가로 받아야 할 때가 있습니다. 이 경우 카카오 로그인 후 서비스 페이지에서 직접 동의나 정보 제공을 요청해야 합니다.

다만 추가 정보 입력 단계에서 사용자가 회원 가입을 완료하지 않고 이탈할 수 있으므로, 추가 정보는 가능한 한 실제로 필요한 시점에 별도로 수집하는 것을 권장합니다. 자세한 내용은 회원 등록을 참고합니다.

사용자가 카카오계정을 탈퇴하려면 먼저 연결된 서비스를 모두 정리해야 합니다. 카카오계정 탈퇴를 시도하는 사용자를 확인하려면 연결 해제 웹훅을 설정합니다. 카카오로부터 연결 해제 웹훅을 받아 서비스에서 해당 사용자의 계정을 후처리할 수 있습니다. 자세한 사양은 연결 해제 웹훅을 참고합니다.

네. 카카오톡에서 자동 로그인 기능을 사용해 구현할 수 있습니다. 사용자의 가입 상태에 따라 로그인 또는 미로그인 상태 중 적합한 화면을 보여줄 수 있습니다. 이 기능은 카카오톡 인앱브라우저에서만 정상 동작합니다.

개인정보 동의항목은 서비스의 회원 가입 절차를 기준으로 심사됩니다. 신청 전에 아래 항목을 확인합니다.

아래 문서를 참고해 보완 후 다시 신청합니다.

• 개인정보 동의항목 추가 기능 신청
• 심사 체크리스트
• Q. 개인정보 동의항목 추가 기능 신청이 반려되었어요.

앱 상태, 비즈 앱 전환 여부, 비즈니스 채널 연결 여부, 추가 기능 권한 보유 여부에 따라 설정할 수 있는 동의항목과 동의 단계가 다릅니다.

설정 가능한 동의 단계와 카카오 로그인 동의항목에서 설정할 수 있는 동의항목과 동의단계를 확인한 후, 필요시 개인정보 동의항목 추가 기능을 신청합니다.

단, 서비스 회원 가입에 반드시 필요한 정보만 필수 동의로 신청하고, 선택적으로 필요한 정보는 선택 동의로 신청하거나 서비스 이용 중 별도 동선에서 수집하는 것을 권장합니다.

네. 새로 추가하거나 변경한 서비스 약관을 [필수 동의]로 등록한 뒤, 필요한 시점에 서비스 약관 선택해 동의 요청 API를 호출해 다시 동의받을 수 있습니다.

단, 이미 사용자가 동의한 약관이나 [선택 동의] 약관만 요청하면 동의 화면이 표시되지 않습니다.

서비스 앱과 카카오톡 채널은 별개의 대상입니다. 서비스 앱과의 연결을 끊더라도 카카오톡 채널 친구 상태는 유지됩니다. 고객 문의를 받았다면 사용자가 카카오톡에서 해당 채널을 차단하도록 안내합니다.

탈퇴 시 서비스 회원 데이터베이스에서 해당 사용자의 정보를 완전히 삭제했는지 확인합니다.

삭제하지 않은 경우, 같은 카카오계정 사용자가 서비스에서 탈퇴 후 다시 연결 시 기존과 같은 회원번호로 발급됩니다. 단, 2018년 9월 19일 이전 생성 앱에서 [사용자 아이디 고정]을 사용하지 않는 경우에는 연결 해제 후 재연결 시 회원번호가 변경될 수 있습니다.

기존 사용자 정보가 남아 있으면 문제가 될 수 있으므로 서비스 정책과 관련 법령에 따라 탈퇴 사용자 정보를 올바르게 삭제 처리해야 합니다.

카페24, 아임웹, 고도몰 등 호스팅사를 통해 카카오싱크를 설정한 경우 일부 설정은 카카오디벨로퍼스가 아니라 호스팅사 관리자 화면에서 변경해야 합니다.

아래 항목을 확인합니다.

• 호스팅사 관리자 화면의 쇼핑몰 URL, 서비스 약관 URL, 개인정보 처리방침 URL이 최신 정보인지 확인합니다.
• 호스팅사 관리자 화면의 카카오싱크 또는 카카오 로그인 설정이 정상 저장되었는지 확인합니다.
• 카카오싱크 설정을 해제하거나 다른 앱 또는 채널로 재연동해야 한다면 호스팅사 관리자 화면에서 먼저 해제합니다.
• 직접 해제할 수 없는 경우, 앱 ID 또는 REST API 키, 쇼핑몰 URL, 해제하려는 채널 정보를 준비해 문의합니다.

카페24에서 카카오싱크를 설정하는 방법은 카페24 카카오싱크 설정 가이드를 참고합니다.

호스팅사 관리자 화면의 카카오싱크 또는 카카오 로그인 설정이 정상 저장되었는지 먼저 확인합니다. 간편설정 팝업으로 도입한 쇼핑몰은 호스팅사가 전달하는 쇼핑몰 정보를 기준으로 카카오싱크 설정이 반영되므로, 카카오디벨로퍼스에서 직접 수정하면 호스팅사 설정과 카카오 설정이 다시 달라질 수 있습니다.

설정 변경 후에도 반영되지 않으면 아래 정보를 준비해 호스팅사 고객센터에 문의합니다.

• 쇼핑몰 URL
• 카카오디벨로퍼스 앱 ID 또는 REST API 키
• 변경하려는 항목
• 호스팅사 관리자 화면에서 저장한 시각과 오류 메시지

호스팅사에서 카카오 확인이 필요하다고 안내한 경우, 같은 정보를 포함해 데브톡으로 문의합니다.

카페24 관리자 화면에서 설정한 회원 가입 항목이나 서비스 약관이 카카오싱크 동의 화면에 반영되지 않는다면 아래 항목을 확인합니다.

• 회원 가입 항목은 카페24 관리자 화면에서 상세 항목 표시 설정이 켜져 있는지 확인합니다. 설정되어 있지 않으면 기본 항목만 동기화될 수 있습니다.
• 서비스 약관은 카카오디벨로퍼스가 아니라 카페24 관리자 화면에서 설정하고 동기화해야 합니다.
• 카카오디벨로퍼스 앱과 카카오톡 채널이 연결되어 있는지 확인합니다.
• 회원 가입 항목 또는 이용 약관 설정 화면에서 [저장]을 눌러 다시 동기화합니다.
• 계속 반영되지 않으면 쇼핑몰 URL, 앱 ID 또는 REST API 키, 저장 시각, 오류 메시지를 준비해 카페24 고객센터에 문의합니다. 카카오 확인이 필요하다고 안내받은 경우 같은 정보를 포함해 데브톡으로 문의합니다.

카페24 간편설정 팝업으로 카카오싱크를 도입한 경우, 아래 설정은 카카오디벨로퍼스가 아니라 카페24 관리자 화면에서 수정해야 합니다.

• 쇼핑몰 URL
• 서비스 약관 URL과 개인정보 처리방침 URL
• 쇼핑몰 회원 가입 시 수집하는 정보 항목
• 선택 제공 동의항목
• 카카오 로그인 또는 카카오싱크 사용 여부
• 카카오싱크 해제 또는 재연동

카카오디벨로퍼스에서 직접 수정할 수 없다는 메시지가 나타난다면 카페24 관리자 화면의 카카오싱크 설정을 먼저 확인합니다. 도메인 추가나 약관 추가도 카페24 관리자 화면에서 설정 후 동기화합니다.

네. 기존 카카오 로그인에 사용하던 앱과 동일한 앱으로 카카오싱크 간편 설정을 완료하면, 기존 사용자도 기존 계정 그대로 로그인하고 서비스를 사용할 수 있습니다.

새 앱을 선택하거나 새 앱을 생성해 카카오싱크를 설정하면 기존 사용자와 다른 회원번호가 발급되어 새 사용자로 처리될 수 있으므로, 기존 앱을 선택해야 합니다.

카페24에서 등록한 사업자등록번호와 카카오디벨로퍼스 앱에 설정된 사업자등록번호가 일치해야 앱 목록에 표시됩니다.

아래 항목을 확인합니다.

• 카페24 관리자 화면의 사업자등록번호가 000-00-00000 형식으로 입력되어 있는지 확인합니다.
• 카페24와 카카오디벨로퍼스의 사업자등록번호가 하이픈(-)까지 동일한지 확인합니다.
• 로그인한 카카오계정이 해당 앱의 관리자 권한을 가지고 있는지 확인합니다.

카카오싱크 간편 설정 시 기존에 사용하던 앱이 아닌 다른 앱을 선택했거나 새 앱을 생성한 경우입니다. 앱이 달라지면 같은 카카오계정 사용자라도 회원번호가 달라져 기존 회원으로 식별할 수 없습니다.

카페24 관리자 화면에서 카카오 로그인을 사용 안 함으로 저장한 뒤, 다시 설정할 때 기존에 사용하던 앱을 선택합니다. 잘못 설정한 앱으로 이미 가입한 사용자는 기존 앱으로 설정을 복구한 후 다시 가입해야 할 수 있습니다.

이 메시지는 카페24에서 처리하는 메시지입니다.

카카오 로그인으로 생성한 카페24 회원이 쇼핑몰에서 탈퇴했거나 관리자가 삭제한 뒤 같은 카카오계정으로 다시 로그인할 때 발생할 수 있습니다.

카페24 정책에 따라 카카오 로그인으로 생성된 계정이 탈퇴 처리된 경우 재가입이 불가능할 수 있으므로, 해당 회원 상태와 재가입 가능 여부는 카페24 관리자 화면 또는 카페24 고객센터를 통해 확인합니다.

이 메시지는 카페24에서 처리하는 메시지입니다.

카페24와 같은 호스팅사를 통해 카카오 로그인 및 카카오싱크를 사용하는 경우, 클라이언트 시크릿을 사용할 수 없습니다.

앱 관리 페이지의 [앱] > [플랫폼 키] > [REST API 키]에서 사용 중인 REST API 키에 클라이언트 시크릿이 활성화 상태인지 확인합니다. 클라이언트 시크릿을 비활성화하거나 삭제한 뒤 다시 시도합니다. 클라이언트 시크릿을 비활성화한 뒤에도 같은 메시지가 계속 표시되면 카페24 고객센터에 문의합니다.

버튼 이미지 설정은 카페24 관리자 화면에서 변경해야 합니다. 설정 위치나 적용 방법은 카페24 고객센터에 문의합니다.

버튼은 카카오싱크 디자인 가이드를 참고하거나, 리소스 다운로드에서 다운로드해 사용할 수 있습니다.

호스팅사 관리자 화면에서 직접 카카오싱크를 해제할 수 없는 경우, 아래 정보를 준비해 데브톡 또는 카카오싱크 고객센터로 문의합니다.

• 앱 ID 또는 REST API 키
• 사용 중인 호스팅사와 쇼핑몰 URL
• 해제하려는 카카오톡 채널 이름 또는 검색용 아이디
• 호스팅사 관리자 화면에서 직접 해제할 수 없는 사유

해제가 완료되면 새 호스팅사 또는 새 쇼핑몰에서 사용할 앱과 채널을 다시 선택해 카카오싱크를 설정합니다. 기존 카카오 로그인 사용자를 유지해야 한다면 가능하면 기존 앱을 계속 사용하는 것을 권장합니다.

기존 카카오 로그인 또는 카카오싱크 사용자가 있다면 기존 앱과 채널을 유지하는 것을 권장합니다. 새 앱을 사용하면 앱 키와 사용자 식별자인 회원번호가 달라져 기존 사용자를 같은 사용자로 처리할 수 없습니다.

이전 전 아래 항목을 확인합니다.

• 기존 쇼핑몰에서 사용한 앱 ID와 앱 키
• 새 호스팅사가 카카오싱크 간편설정을 지원하는지 여부
• 기존 앱과 새 쇼핑몰의 사업자 정보가 일치하는지 여부
• 기존 회원의 회원번호를 새 쇼핑몰 회원 데이터로 이관할 수 있는지 여부
• 기존 회원을 어떤 기준으로 매핑할지에 대한 서비스 정책

기존 앱을 계속 사용할 수 없는 경우, 서비스에서 기존 회원 매핑과 재동의 동선을 별도로 구현해야 합니다. 자세한 내용은 기존 회원 연동을 참고합니다.

동일한 회원 체계와 동일한 서비스를 제공하는 경우라면 하나의 앱에 웹 도메인과 리다이렉트 URI를 추가해 사용할 수 있습니다.

하지만 서로 다른 호스팅사나 쇼핑몰이 각각 별도 회원 체계를 운영한다면 하나의 앱을 동시에 연결하는 것을 권장하지 않습니다. 사용자가 어느 쇼핑몰에서 가입했는지에 따라 다른 쇼핑몰에서 다시 가입 절차가 진행될 수 있고, 간편설정 시 동의항목과 서비스 약관이 마지막으로 연동한 호스팅사 설정으로 변경될 수 있습니다.