Skip to main content

Before you start

  • You need write access to API keys in the business that owns the app.
  • Plan the redirect URLs, the scopes, and the reason for each scope. Merchants read the reasons on the consent screen.

Create the app

1

Open the Created tab

In the dashboard at app.dodopayments.com, open Apps, select the Created tab, and select Create app.
2

Fill in the app basics

The wizard is titled Register a new app. Step 1 is App basics.
3

Choose the access and the redirect URLs

Step 2 is Access and permissions. Select the scopes that the app needs. Each resource has the level None, Read, or Write.Add 1 to 10 OAuth redirect URLs. Dodo Payments sends the merchant to one of them after the install. Each URL must use https and cannot contain #.
Request only the scopes that the app uses. Scopes for money movement and customer data get extra attention in review.
4

Set the webhooks

Step 3 is for Webhook endpoints and Webhook events. Both are optional.
  • Live endpoint: live installs send events here.
  • Test endpoint: test installs send events here. With no URL, test installs send no events.
  • Webhook events: you can select only the events that a selected scope covers. The form does not accept events without a webhook URL. It shows “Enter a webhook URL to get the selected events.”
5

Create the app and copy the credentials

Select Create app. The Credentials dialog shows the Client ID and the Client secret. Copy the secret now. It shows only one time.If you lose the secret, rotate it on the app page.
Every new app is private. Only your business and your testers can install it.

The app page

Open the app from the Created tab. The page has four tabs.

Listing details

Open the listing fields with Edit, or in the Make public wizard. These fields are needed for the review:

Scopes and reasons

Write a reason for each requested scope. The consent screen shows the reason to the merchant. A review needs a reason for each scope.

Rotate the secret and revoke tokens

  • Rotate secret: the old secret stops working at once. Update your servers first.
  • Revoke access tokens (in the danger zone): revokes every token of the app. Each merchant loses access within 2 minutes, and each install gets app.uninstalled.
  • Delete app: removes the app from every business that installed it.

Add testers

Open the Testing tab. Select Create test link and share the link. Up to 25 other businesses can join and install the app before it is public. Select New link to stop new joins with the old link. Businesses that joined stay testers. Select Remove to remove a tester. See Test your app.

Edit a live app

When you edit a live app, changes to the listing, the permissions, the redirect URIs, and the webhooks go to review. The live version stays until approval. See Submit for review and publish.
Last modified on November 16, 2026