kakao developers

Prerequisites

This document explains what you have to do before integrating Kakao Sync.

Tag used in this document

Tag	Description
Required	You must apply the settings marked with this tag before using the Kakao APIs. If this tag is not attached, you can optionally apply the setting depending on the functions you want to use.

What you need

Here are the materials required to complete the prerequisites. To create or set each one, you need to visit different websites.

Material	Description	Website
Kakao Account	An account used for the Kakao services including Kakao Developers	My Kakao Account
Business Channel	A Kakao Talk Channel used for marketing and displayed in the Kakao Sync Simple Signup screen	Kakao Talk Channel Admin Center
Business Application	A service application registered in the Kakao Developers	Kakao Developers
Set as a team member	Team is a system to manage the app access levels. If you want several developers to manage your app, register the developers as team members in [My Application] > [Team Management]. Only team members can see or modify app information.	Kakao Developers

1. Set up your app Required

Add an application and register your service and company information in the Kakao Developers. If your service is already using Kakao Login, skip to 3. Set up Kakao Talk Channel.

What you do	Required
Create an app. IMPORTANT: If your service already has an app in the Kakao Developers, you must use the existing app to adopt Kakay Sync, not register a new app. Otherwise, you cannot use the user data linked with your existing app.	O
Register platforms.	O
Manage team members.	O

2. Set up for Kakao Login Required

Because Kakao Sync is an extended version of Kakao Login, you must set for Kakao Login ahead before applying Kakao Sync.

What you do	Required
Activate Kakao Login.	O
Register Redirect URI.	O
Set consent items.	O

3. Set up Kakao Talk Channel Required

Kakao Sync provides a function to add the channel addition option to the Simple Signup Consent screen. This function enables users to decide whether to get news from your Kakao Talk Channel on the Consent screen when they log in. To use this function, you must do the followings:

What you do	Required
Switch to a Biz app. IMPORTANT: Only allowed with the Owner accountAccount that has all permission for the app, such as viewing or modifying all app information, inviting a member, switching to a Biz app, re-issuing app keys or deleting an app..	O
Upgrade to Business channel in Kakao Talk Channel Admin Center. IMPORTANT: Only allowed with the Master account. NOTE: If you do not have a Kakao Talk channel, create a new Kakao Talk Channel. To check if your business information is saved, go to [관리(Management)] > [비즈니스 채널(Business channel)] > [채널 신청(Apply channel)] in Kakao Talk Channel Admin Center.	O
Connect your Biz app to your Business Channel in Kakao Business. Only after a Biz app is connected to a Business Channel, you can get permission to use particular user information. IMPORTANT: See Conditions for app and channel connection.	O
Select a primary channel to be displayed on the Simple Singup Consent screen.	O

Connect app to channel

Visit Kakao Business, and connect your Biz app and Bisuiness channel as follows:

➊ In Kakao Business Admin Center, go to [내 비즈니스(My Business)] > [비즈니스 설정(Business Settings)] > [채널-앱 연결(Channel-app connection)] in Kakao Business and click [비즈앱-채널 연결하기(Connect Biz app-Channel)]. Only when the conditions are met, '비즈앱-채널 연결하기(Connect Biz app-Channel)' is displayed. ➋ Select a Biz app. ➌ Select one or more Kakao Talk Channels on the list. Only the channels that meet the conditions are displayed on the list. ➍ Click [연결하기(Connect)], and then the selected app and channels are connected.

If an app and a Kakao Talk Channel have already been connected, the connected app and channels are displayed. You can connect an app and channels additionally by clicking [비즈앱-채널 연결하기(Connect Biz app-Channel)]. If you want to disconnect the connection or have any questions, contact Kakao Customer Service.

Conditions for app and channel connection

• Your app must be a Biz application with the business registration number registered.
• Your Biz app's account logged in Kakao Developers must have an EditorAccount with permission to view or modify the app information or OwnerAccount with all permissions such as modifying the app information, deleting an app, or inviting a member role. For a Kakao Talk Channel,
• Your Kakao Talk Channel must be a Business Channel with the same business information registered as your Biz app.
  • If you already have a channel to use other Kakao services, such as Talk Store, go to [관리(Management)] > [비즈니스 채널(Business channel)] > [채널 신청(Apply channel)] in Kakao Talk Channel Admin Center, and then check if your business information is saved. If not saved, specify your information.
• Your Business's account logged in Kakao Business must have the Master or Manager role.
• Your Kakao Talk Channel must not be connected to any other app.

4. Apply Kakao Sync Required

To apply Kakao Sync, you need to input the required information and request permission for user information that your service needs.

Input information

If your service applies Kakao Sync, users can simply sign up by consenting to the Terms of Service and the Provision of Personal information on the Simple Signup Consent screen. Thus, make sure to input the correct information.

1. Select the '카카오싱크 신청(Apply for Kakao Sync)' menu in Kakao Business Admin Center.
2. If you have not saved a verified phone number in your Kakao Account, you are requested to input your phone number by clicking [연락처 등록하기(Register contact)]. The registered phone number is used for users to contact if errors occur while adopting Kakao Sync service. If your phone number has already been saved, you can skip this step.
3. Select a type of operating your service. Ensure that you cannot change this type later on after selecting an option in this step.
   3-1. If you are operating your own website, not using a web hosting service, select '호스팅사에 속하지 않는 독립몰(If operating your own website)'.
   3-2. If you are using a web hosting service, select '호스팅사를 이용하고 있는 경우(If using a web hosting service)', and then select one of the hosting services among 카페24(cafe24), 식스샵(sixshop), 메이크샵(MakeShop), 아임웹(I'mweb), 위사(WISA) and 가비아(gabia). If you are using the web hosting service affiliated with Kakao, you can request a review only for CI among user information in Kakao Business Admin Center, and then input the rest information in the web hosting service website. If you are not using one of the supported web hosting services, you cannot use Kakao Sync. In this case, ask the web hosting service you are using for their plan to adopt Kakao Sync.
   
4. If you apply for Kakao Sync for the first time, enter the information in 카카오 로그인시 개인정보제공 항목 검수(Review for Provision of Personal Information for Kakao Login). This review is required to protect personal information, and Kakao reviews the personal information to be provided. After a review is passed, you can ask for consent to the personal information in your service.

Review for Provision of Personal Information for Kakao Login

You can decide what kinds of user information you will collect or whether to set each user information to Required or Optional consent item. However, to retrieve some user information, a review is required to get permission. Some user information can be set as a 'Required consent' item only after registering a business registration number, or this review is passed.

🅐 Select the checkboxes of user information to be provided. 🅑 Select the '필수 수집 항목(Required collecting data)' or '선택 수집 항목(Optional collecting data)' option for each user information you selected.

'필수 수집 항목(Required collecting data)' refers to the information required for a service and users must input when signing up. Thus, if users do not provide or agree to provide, Simple signup or login is not completed. In the case of the '선택 수집 항목(Optional collecting data)', users can finish login or Simple signup without consent to the user data. If your service must get specific user information, set it to '필수 수집 항목(Required collecting data).

🅒 Input the purpose of collecting the user information in your service in '수집 사유(Reason for collecting data)'. This field is required because Kakao needs to check how each user information is used in your service. 🅓 In '서비스 회원가입 링크 URL(URL of signup for service)' under '추가 서류 제출(Submit additional material)', input the URL where we can check what kinds of user information your service collects during a signup process. Additionally, upload material to prove the reason for collecting the user information by clicking '업로드(Upload)'. If you are operating a service, you must attach the current signup page. If the signup page has not been developed yet, you can upload a plan or a design draft instead for the material.

After settings above, click [신청하기(Apply)] to ask for a review.

If the purpose for collecting user information is not clear or proper, you may not get permission to use the user information. For example, if an online store for clothes chooses to get users' shipping addresses to deliver clothes, the request is surely accepted. However, if a service that does not need shipping addresses requests shipping addresses, the service may fail to get permission through the review.

Kakao refrains from providing unnecessary user information. Therefore, you need to choose only the user information to be used in your service and decide to collect the user information optionally or mandatorily according to your service's needs.

After asking for review

After you input the information to use Kakao Sync, Kakao reviews the items of personal information to be provided you have input and the attached materials. It takes 3 to 5 business days to review. Kakao checks if the request information coincides with your service information. After a review is passed, your service can get permission to use personal information and use related functions.

To see the review result, select '검수 결과 확인(Check review result)' in the '카카오싱크 신청(Apply for Kakao Sync)' menu. If a review is passed, proceed to the next step. If failed, we will inform you of a rejection reason.

To get permission to use more user information in your service or request a review again after rejection, go through the procedures in the same way as applying for Kakao Sync described above. It also takes the same period, 3 to 5 days. To withdraw some permissions, you can simply change the settings in [My Application] > [Kakao Login] > [Consent Items].

5. Manage terms Required

After a review is passed, you can enable the Simple Signup function that enables your service to obtain consent to all terms at once on the Simple Signup Consent screen.

Go to [My Application] > [Kakao Login] > [Simple Signup], and then add a new term or modify the registered term by referring to Set Simple Signup.

Note that only the app that has been passed the review can use the Simple Signup function.

6. Set up test environment

If you are already using Kakao Login or other Kakao APIs or have any issues while operating your service, you need to set up a test environment for Kakao Sync development. Make sure that you should set up after Kakao Sync review is passed.

1. In Kakao Developers, go to [My Application] > [General] > [Test App Information] and create a test app.
2. In Kakao Talk Channel Admin center, click [개발자용 채널 만들기 (Create a channel for developers)], and then create a test channel.
3. In Kakao Business Admin Center, select [카카오 싱크(Kakao Sync)], and connect a test app and a test channel. Then, set a primary channel.
4. In Kakao Developers, go to [My Application] > [General] and click [Sync permission with a test app] under 'Test App Information' to apply your app information to a test app.
5. Configure your test app if necessary,and then test with the test app.

See more

Next step

• Planning

Related topics

• Concepts
• FAQ