> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# App Marketplace for Developers

> Learn the concepts of a Dodo Payments app: the app, the installation, the access token, scopes, test mode and live mode, and the lifecycle from private app to listed app.

## What you can build

An app is a program that a merchant installs in a Dodo Payments business. After the merchant approves the permissions, your app calls the Dodo Payments API for that business and receives webhooks about it. You can list the app in the App Marketplace so that all merchants can find it.

> [!NOTE]
>
> The App Marketplace is available only to businesses that have the `app_marketplace` feature enabled. Testers need the feature too.

## Concepts

| Term | Meaning |
| - | - |
| App | Your app definition: name, listing, redirect URIs, scopes, webhook URLs, and subscribed events. The ID starts with `app_`. |
| Client ID and client secret | The OAuth credentials of the app. The client ID is the app ID. The client secret starts with `dodo_cs_` and shows one time. |
| Installation | One merchant business that installed your app in one mode. The ID starts with `ains_`. |
| Access token | A token for one installation. It works only for that business and mode, and only for the granted scopes. It lasts 1 hour. |
| Refresh token | Gets a new access token. It lasts 365 days, and each use gives a new refresh token. |
| Scope | A permission, for example `payments:read` or `refunds:write`. The merchant approves all scopes or none. |
| Mode | Live or test. Each mode has its own installs, tokens, and webhooks. |
| Manifest | An optional list of settings fields that the merchant fills on the **Configure** tab. See [App Settings](https://docs.dodopayments.com/developer-resources/apps/app-settings/overview.md). |

## Test mode and live mode

A merchant installs your app one time for each mode. The mode comes from the `resource` value in the authorization request: `https://test.dodopayments.com` for test, and `https://live.dodopayments.com` for live. Each install has its own tokens, scopes, and webhooks. Test installs use `webhook_url_test`.

## Lifecycle

An app has one of these statuses:

| Status | Meaning |
| - | - |
| **Private** | The default. Only your business and your testers can install the app. No review is needed. |
| **In review** | You submitted the app. A reviewer checks it. |
| **Live** | The app is listed in the marketplace. |
| **Rejected** | The reviewer refused the app and gave a reason. Fix it and submit again. |
| **Delisted** | The app is not in the marketplace. Current installs keep working. |
| **Suspended** | Merchants cannot install the app, its tokens do not work, and its webhooks stop. |

```mermaid theme={null}
stateDiagram-v2
    [*] --> Private: create app
    Private --> InReview: submit for review
    Rejected --> InReview: submit again
    InReview --> Live: approved
    InReview --> Rejected: rejected
    Live --> Delisted: delisted
    Live --> Suspended: suspended
    Suspended --> Live: suspension lifted
```

A suspension can also happen to an app in another status. When it is lifted, the app returns to its earlier status.

## The installation lifecycle

```mermaid theme={null}
sequenceDiagram
    participant M as Merchant
    participant A as Your app
    participant D as Dodo Payments
    M->>A: Select Install
    A->>D: Authorize request with PKCE
    D->>M: Consent screen
    M->>D: Approve
    D->>A: Authorization code
    A->>D: Token request
    D-->>A: Access and refresh tokens
    D-->>A: app.installed webhook
    M->>D: Uninstall
    D-->>A: app.uninstalled webhook
    D-->>A: business.redact webhook after 48 hours
```

## Path to a listed app

**1. Create the app**

See [Create an app](https://docs.dodopayments.com/developer-resources/apps/create-an-app.md).

**2. Build the install flow and webhooks**

See [OAuth and tokens](https://docs.dodopayments.com/developer-resources/apps/oauth-and-tokens.md) and [Webhooks for apps](https://docs.dodopayments.com/developer-resources/apps/webhooks.md).

**3. Add settings (optional)**

See [App Settings](https://docs.dodopayments.com/developer-resources/apps/app-settings/overview.md).

**4. Test**

See [Test your app](https://docs.dodopayments.com/developer-resources/apps/test-your-app.md).

**5. Submit for review**

See [Submit for review and publish](https://docs.dodopayments.com/developer-resources/apps/submit-for-review.md).

For one page with all steps in short form, see [Build an app](https://docs.dodopayments.com/developer-resources/build-an-app.md).


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.