페이지 이동경로
  • Docs>
  • Introduction>
  • Application

Introduction

Application

This document guides information for the application("app").

Basic information

The basic information contains the app name, icon, and company name. The basic information can be modified on [My Application] > [General] > [Basic information] > [Modify].

The app's basic information is presented on the consent screen for Kakao Login, the connected services page, the bottom of the Kakao Talk messages, and is required for Verify business information. To let users recognize the service correctly, register the app's basic information as the same as the actual service.

Where the app's basic information is presented.

App key

The app keys are needed for the authorization of Kakao API requests. To check the app keys, go to [My Application] > [App Keys] or [My Application] > [Summary].

How to check app keys

The app keys are issued by the platform. If an app key is used on the wrong platform, an error response is returned.

  • Native app key: Used to initialize the Kakao SDK for Android or initialize the Kakao SDK for iOS.
  • REST API key: Used to call APIs using a REST API.
    Pass this key in the HTTP request header when you send a request in a server environment.
  • JavaScript key: Used to initialize the Kakao SDK for JavaScript SDK.
  • Admin key: Used to call the APIs intended for administrators using a REST API. Be sure that your app’s Admin key does not get exposed because this key has all permissions.

Reissue

If one of the app keys is revealed, the OWNER can reissue the app keys. Make sure that the reissue is irreversible. After the reissue, the app keys in the service app or website must be changed to the reissued value.

Platform

Kakao APIs are only allowed to the services that registered platform information. To register platform information, go to [My Application] > [Platform].

Note: Error due to incorrect platform information

If the registered platform information is different from the actual service, invalid android_key_hash or ios_bundle_id or web_site_url error occurs. In this case, check the list below.

  • Android: Check if the registered [Package name] is the same as the value of the package attribute in AndroidManifest.xml and if a Key hash is registered.
  • iOS: Check if the registered [Bundle ID] is the same as the value of the [Project] > [TARGETS] > [General] > [Identity] > [Bundle Identifier].
  • Web: Check if the site domain used to call the Kakao API is registered.
Note: Market URL

A market URL is an open market URL registered in [Platform]. Messages sent by Kakao Talk Sharing or Kakao Talk Messaging APIs provide a link to launch the service app. If the service app is not installed on the user's device when launching the service app, the market URL will be opened.

Android

Dialog box for registering Android platform

🅐 Package Name

  • Unique identifier of the Android app
  • Enter the value of the package attribute in AndroidManifest.xml

🅑 Market URL

  • If [Google Play] is selected, market URL is automatically entered with [Package Name]
  • If [Enter directly] is selected, enter the full market URL, such as One store

🅒 Key hash

  • Key hashes to authenticate for Kakao API requests
  • Refer to Add key hashes and register key hashes by the development environment

iOS

Dialog box for registering iOS platform

🅐 Bundle ID

  • Unique identifier of the iOS app
  • Enter the value of [Bundle Identifier] in the Xcode project information

🅑 Appstore ID and Market URL

  • Enter the App ID in the Appstore
  • Market URL is automatically entered with [App ID]

Web

Dialog box for registering Web platform

🅐 Site domain

🅑 Default domain

  • If more than one site domain is registered, the site domain registered on the top line is set to the default domain
  • Default domain is used as the default value for the link in the message that sent by Kakao Talk Sharing or Kakao Talk Messaging APIs
Note: Wildcard subdomains

Biz app is allowed to set wildcard subdomains Kakao Login Redirect URIs. When using subdomains containing wildcard characters, refer to the rules below.

  • Domains with wildcard characters cannot be the default domain
  • If only domains with wildcard characters are registered, some functions may not work properly
  • Each subdomain must include a unique domain name or hostname
    • https://*.sample.com (O)
    • https://*.com (X)
  • Subdomains cannot include wildcard characters in the middle of the domain
    • https://*.sample.com (O)
    • https://sub.*.sample.com (X)
  • Subdomains cannot include more than two wildcard characters
    • https://*.sample.com (O)
    • https://*.*.sample.com (X)

Team management

A team is a system to manage access permission by developer account for each app. Only the developers with developer accounts are registered as team members can view or modify the app information. Only the team members are authorized to make Kakao API calls for a test app.

Role type

  • OWNER
    • The user who owns the app
    • Available to view or modify all of the app settings, invite a member, switch to a Biz app, reissue app keys, delete the app, or Request for app permissions
  • EDITOR
    • Available to view or modify app settings, or Request for app permissions
    • Not available to invite a team member, reissue app keys, or delete the app
  • EDITOR_MESSAGE_TEMPLATE
    • Available to view app settings and create or modify message templates
  • READER
    • Available to view app settings only

How to manage

How to manage team members

🅐 Invite team member

  • Enter the email of the developer account and set a role
  • Only the email used for logging in with a Kakao Account is allowed
  • An email will be sent when inviting
  • If required, a new Kakao Account can be registered on the Kakao Account page

🅑 Team member information and management

  • Kakao Account: The email of the team member's Kakao Account
  • Role: The team member's role type
  • State: The team member's state
    • Active: A user who registered as a developer account and a team member properly
    • Invitation sent: A user who has registered as a developer account not yet, can be a team member through the invitation email
    • Dormant: A user who is in the dormant state, the user's email is not shown to all team members and cannot be modified or exported
  • Management
    • Provides role modification and export function
    • OWNER can [Edit] or [Export] for each team member
    • Team members can export themselves from the team using [Leave the team]
    • OWNER role can be transferred to other team members by modifying team member permissions

How to change OWNER

  1. Login to the Kakao Developers with the OWNER developer account
  2. Add the new developer account as a team member on [My Application] > [Team Management] > [Invite team member]
    • To use a new Kakao Account, sign up a new Kakao Account and register as a developer account in Kakao Developers
  3. Click [Modify] on the team member list and change the role to the OWNER

If the app OWNER is unknown or missing, refer to FAQ.

Biz app

The Biz app is an application that has registered the service's business registration number.

Additional features

The Biz app provides additional features below.

Switch to a Biz app

To upgrade the app to a Biz app, enter the business registration number on [My Application] > [Business], and click [Register business information]. Only the OWNER can switch the app to a Biz app.

How to register Biz app information
Note: Biz app for an individual

The Biz app is also available for individuals, celebrities, or governmental entities without a business registration number. If the app meets the guidelines below, it can be switched to a Biz app on [My Application] > [Business] > [Biz app for an individual].

  • The app's OWNER must complete the user identification process on [Account settings] at the top right side of Kakao Developers
  • Consent to Kakao Business consolidated service terms.
Note: Link with a Business channel

The Biz app for an individual cannot link with a Business channel because it has no business information. If Kakao Sync is needed, the app must have the business information to link with a Business channel. The business information can be registered on [My Application] > [Business] even after switching to a Biz app for individuals.

For overseas companies

If an overseas corporation operates the service, request a review through Devtalk to switch to a biz app. Leave the information below.

  • The app ID and app name
  • Required APIs or functions

During the review, we will ask for the certificate that authenticates the overseas corporation.

Test app

The test app is provided for updating or adding a new feature to the service. The test app has built-in permissions to preview features before requesting a review.

Only the Biz app can use the test app. And you can create up to five test apps per original app.

Features

These are the main features that the test app provides.

  • Built-in permissions for test apps to preview features before submitting a review of the original app
  • Available to use independent test app settings that differ from the original app settings
  • Permissions are automatically applied to the test app when permissions are added or deleted to the original app (Ex: Kakao Business privacy review or separate permissions for APIs, such as Kakao Social, Messages, and Talk Calendar)

How to create

To create a test app, go to [My Application] > [General] > [Test App Information], and select [Create a test app].

How to create a test app

[Test app] is a list of the test apps. Select the name of the test app to go to the settings screen.

How to select a test app

The test app provides a separate app key, independent settings, and permissions that differ from the original app.

Information of a test app

Limitations

Consider the limitations below when using test apps.

  • The original app with test apps is not deletable.
  • When initially created, the test app had the same OWNER and team members as the original app
    • If the OWNER changes in the original app, the test app's OWNER will also change and cannot change the OWNER of the test app separately
    • Except for the OWNER, team members in a test app can be added or removed regardless of the original app
  • Test apps have a maximum number of team members
  • Test apps have a separate quota limit
Caution

Make sure that the test app is not applied to your actual operating service. Test apps are only features provided for testing purposes and have separate quota limits. Use for purposes other than testing will be penalized.

Built-in permissions for test apps

Below is the complete list of permissions provided for the default test app. To use additional permissions in the original app, you need to obtain the permissions separately by reviewing.

Request for app permissions

Requests your app be reviewed for additional permissions. After review, you will be provided with approved permissions to utilize. For the List of permissions you can currently request with Request for app app permissions, see Request for app permissions list.

To request app permission review, go to [My Application] > [App Settings] > [Request for App Permissions]. You must complete Confirm qualifications before the request. Refer to the details below.

For information on viewing and disconnecting Kakao Talk Channel lists, refer to Manage Kakao Talk Channel Connection.

Request for app permissions screen

🅐 Confirm qualifications 🅑 Verify business information 🅒 List of app permissions 🅓 Review state

Confirm qualifications

Checks the app and account's qualifications to request for app permissions. The app and account must meet the Conditions for confirming qualifications.

  1. If you do not meet the Conditions for confirming qualifications, guidance related to 🅐 Confirm qualifications will be displayed. Follow the instructions to configure your app or account.
  2. If you meet the Conditions for confirming qualifications, a [Confirm Qualifications] button will appear under 🅐 Confirm qualifications. Click this button to open a window for Confirm qualifications.
  3. After reviewing and agreeing to the details, the qualification confirmation will be completed.
Conditions for confirming qualifications
  • OWNER or EDITOR role: The access account requires app OWNER or EDITOR role.
  • Identity verification: If the identity verification is not incompleted, follow the instructions to verify your identity.
  • Biz app: If the app is not a Biz app, swiching to a Biz app is required. (See Biz-app)

Verify business information

Requests for business information verification for the app.

  1. Business verification is available after Confirm qualifications. Until then, the [Request] is disabled.
  2. When selecting [Request] for 🅑 Verify business information, the [Business information] input window opens.
  3. Fill in the inputs by referring to the instructions and cautions for each item, and request.

List of app permissions

Requests a review for your app to get additional permissions. You can find the permissions you can request in the Request for app permissions list.

  1. Permission review is available after Confirm qualifications is complete. Until then, the [Request] in the permission list is disabled.
  2. Select [Request] in the 🅒 List of app permissions to open the review request window for that permission. If you request for a permission that requires Verify business information and it is not completed, the business verification window will open first. You can continue after completing business verification.
  3. Refer to the guidance and precautions for each item, fill in the inputs, and submit.
  4. The Review state can be checked in the [State] column, where the [Request] button was located. The approval or rejection state of the requested review will also be sent to the email registered to the account.
Review state

Displays the state of the permission review as below.

  • In progress: The review has been requested and is currently being reviewed by a staff member.
  • Approved: The request has been approved and the app has been granted permission.
  • Partially approved: The request has been partially approved and the app has been granted part of the permission.
  • Rejected: The request was not approved and the app was not granted permission, need to resubmit with deficiencies.

Manage Kakao Talk Channel connection

Manage Kakao Talk Channel connection screen

🅐 List of Kakao Talk Channels

You can check the list of Kakao Talk Channels connected to your app and disconnect them if necessary.

  1. Select [Disconnect] of the channel you want to disconnect from the 🅐 List of Kakao Talk Channels to open the [Disconnect Kakao Talk Channel] window.
  2. Before disconnecting, read the Precautions for disconnecting. Once you have fully understood and agree with the content, select [Disconnect] to disconnect the channel.
  3. You can reconnect a disconnected Kakao Talk Channel by selecting [Connect] from [Request for App Permissions] > [Connect Kakao Talk Channel].
Note: Disconnecting a shopping mall Kakao Talk Channel

If you are using Kakao Sync as a hosting service for your shopping mall, you cannot disconnect the channel with this feature. You need to refer to the hosting company instructions that supports the Kakao Sync Simple Settings popup, and change your hosting company's admin settings.