Skip to main content

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.
The App Marketplace is available only to businesses that have the app_marketplace feature enabled. Testers need the feature too.

Concepts

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: 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

Path to a listed app

1

Create the app

2

Build the install flow and webhooks

3

Add settings (optional)

4

Test

5

Submit for review

For one page with all steps in short form, see Build an app.
Last modified on November 16, 2026