/
Error Code

Error Code

Code

Name

Description

Code

Name

Description

200

Success

  • Success

400

BadRequest

  • Bad Request

    • Occurs when the request sent to the server is incorrect (e.g., unparsable request data, missing required parameters, or parameter type errors)

401

AuthFailure

  • Authentication Failure

    • Occurs when the IDP’s Access Token provided during automatic/manual login is invalid.

403

Forbidden

  • Forbidden Request

    • Occurs when a request is sent by an unauthorized user.

    • ex) Access can be restricted to specific users during a CBT (Closed Beta Test) period..

404

NotFound

  • Unsupported function

    • Occurs when a non-existent server API is called.

406

NotExistData

  • Occurs when requesting non-existent data or making a request beyond the allowed range.

    • ex) Registering a non-existent coupon

    • ex) When requesting an account switch and the account being switched to is already registered in the game.

462

Unregistered

  • Occurs when the user's account status is not normal.

    • ex) In an unregister grace period.

463

Lockout

  • Protection measure status

464

Punishment

  • User under penalty status

465

AlreadyUsedIDPAccount

  • Duplicate IDP Connect

473

ServiceUnavailable

  • Service unavailable (maintenance)

    • Occurs when the platform server is in an unavailable state (e.g., platform server maintenance).

500

InternalError

  • Internal server system error

    • Occurs when an error occurs within the server.

1001

NetworkFailure

  • Network error occurred

    • Occurs when the device is not connected to the network (3G/LTE/Wi-Fi).

2001

ServerTimeout

  • Server Timeout

    • Occurs when the server does not respond within a certain time (20 seconds).

2002

ServerException

  • Exception occurred during server operation

    • Returned when an exception occurs while processing the server response.

2003

InvalidResponse

  • Server sent an incorrect response.

    • Occurs when the server sends an incorrect response.

2004

ConnectionFailed

  • Failed to connect to the session server or the session was disconnected while waiting for a response

    • Occurs when the session is disconnected (due to network switching) while waiting for a response after sending a request through the session server.

3000

InitializationFailed

  • Initialization failed

    • Occurs when platform initialization fails. Check the error message description to identify the problem in the platform configuration.

3001

NotInitialized

  • Not initialized

    • Occurs when an API other than initialize/start is called without initialization.

3002

NotAuthorized

  • Not authorized.

    • Occurs when an API other than the authentication API is called without being authenticated.

4000

InvalidParameter

  • Parameter error.

    • Occurs when there is an issue with the parameters passed during an API call.

4001

ClientException

  • Exception occurred during client operation.

    • Returned when an exception occurs during the operation of the client SDK.

4002

InvalidState

  • State cannot process the request.

    • ex) When requesting an account switch and the current authentication is not device authentication.

    • ex) When calling the KakaoStory API while not being a KakaoStory user.

4003

InProgress

  • The called API is already in progress.

    • ex) Calling the start API while the start API is already in progress.

    • ex) Calling the login API while the login API is already in progress.

4010

IdpAuthFailure

  • IDP authentication failure.

    • Returned when an IDP (Kakao/Facebook/Google, etc.) authentication error occurs.

5001

NotSupported

  • Not supported.

    • When using a coupon API in a channeling game that does not support coupons.

    • When using the Kakao API while device authentication is enabled.

6001

APINotExists

  • The requested API does not exist.

    • Occurs when the requested API does not exist through the interface broker.

7001

ExceedMonthlyUsage

  • Exceeded monthly usage limit.

7002

ExceedDailyUsage

  • Exceeded daily usage limit.

7003

ExceedMaxUploadSize

  • Exceeded maximum upload size.

7004

ExceedMaxUploadNumber

  • Exceeded maximum upload number.

7101

MessageSettingDisabled

  • Message sending failed because the recipient's message reception setting is disabled.

7202

NotKakaoTalkUser

  • Not a Kakao user

7204

AgreementRequired

  • Agreement required

7205

VerifyIdentificationRequired

  • Verification required

7301

SendMessageInMultiPicker

  • Failed to send messages to all users selected in the multi-picker

8001

FacebookNotInstalled

  • Facebook is not installed

8002

GooglePlayServiceNotAvailable

  • Google Play services not available

9001

UserCanceled

  • User canceled

    • Occurs when the user cancels an action involving user interaction, such as IDP authentication or coupon registration.

9999

Unknown

  • Unknown error

    • Returned when an error occurs in an unpredictable situation.

Related content