What does Play Billing DEVELOPER_ERROR (5) mean?

Play Billing DEVELOPER_ERROR (5) means the app called the Play Billing API incorrectly.

Quick facts#


Error	`BillingClient.BillingResponseCode.DEVELOPER_ERROR` (5)
Where	Google Play Billing Library (`BillingResult.responseCode`)
What the vendor says	The error comes from incorrect use of the API.

Cause#

Google's examples: invalid arguments such as an empty product list where one is required, or a misconfigured app, such as one that is not signed or lacks the permissions it needs in its manifest.
Google also says that wrong parameters passed to launchBillingFlow can cause it, and that the debug message gives more detail.
It is a fatal error for that call, so a retry with the same arguments fails again.

Fix#

Read billingResult.debugMessage and log it first; it usually names the problem.
Check the arguments of the failing call: a non-empty product list, product details from the same BillingClient, valid billing flow params.
Install a signed build: Google names an app that is not signed as one cause.
Check that the manifest has the permissions Google's integration guide requires, then rebuild.

Example#

Kotlin

import com.android.billingclient.api.BillingClient
import com.android.billingclient.api.BillingResult

// DEVELOPER_ERROR is a bug in how the app calls the API: the debug message is the fastest clue.
fun onBillingResult(result: BillingResult) {
    if (result.responseCode == BillingClient.BillingResponseCode.DEVELOPER_ERROR) {
        println("DEVELOPER_ERROR: ${result.debugMessage}")
    }
}

Not compiled: this Kotlin snippet was not built here because the docs repo has no Kotlin or Android toolchain. Check it against your Play Billing Library or SDK version before you ship it.

How the RevenueDot SDK reports it#

The RevenueDot purchases-android fork maps DEVELOPER_ERROR to PurchasesErrorCode.PurchaseInvalidError (code 4). See what purchaseInvalidError means.

Source#

Checked: 2026-10-03

Edit this page on GitHub ↗ View as Markdown Last updated October 3, 2026