Skip to main content

Test in test mode

Test installs use test data only and send events to webhook_url_test. Use test mode for all tests before you list the app. Use resource=https://test.dodopayments.com in the authorize and token requests. Call the API at https://test.dodopayments.com.

Install your own app

A private app can be installed by the business that owns it.
1

Open your app

Open Apps, Created, and select your app. Switch the dashboard to test mode.
2

Start the install

Start the OAuth flow from your own install page, or open the authorize URL from the Integrate tab. The Integrate tab lists the authorization URL, the token URL, and the API base URL for the mode.
3

Approve the install

Approve the permissions on the consent screen as an owner or an admin. A private app can be installed on your own business with the OAuth flow. The consent page then shows “Unverified - Test mode”.
4

Check the install

Open Apps, Installed. The app shows as Active. Your webhook endpoint gets app.installed.

Add testers

A test link lets up to 25 other businesses install your app while it is private or in review.
1

Create the link

Open the Testing tab and select Create test link. Copy the link.
2

Share the link

Send it to the tester. The tester opens it as an owner or an admin of their business, and selects Join as tester.
3

Check the testers

The tab shows each tester by name and the count, for example “Testers: 2 of 25”. The tester sees your app in the marketplace with the Test app badge.
If you select New link, the old link stops working for new businesses. Businesses that joined stay testers. The business that owns the app cannot be a tester. Testers need the app_marketplace feature enabled.

Test the redirect URIs

A pending redirect URI of a live app does not work for the install flow. The authorization server uses the approved redirect URIs only. To test a new redirect URI of a live app, use a separate private app.

Checklist

  • The install flow works in test mode with PKCE, and the state check passes.
  • The app exchanges the code and stores the access token and the refresh token.
  • The app refreshes the token and stores the new refresh token.
  • The app calls the API with each requested scope and does not call a resource that it did not request.
  • The app handles 401 and 403 responses.
  • The webhook endpoints return 2xx for a test event.
  • The app verifies the signature of each webhook and ignores a repeated webhook-id.
  • The app handles app.installed, app.installation.updated, and app.uninstalled.
  • The app handles the privacy events if it has customers scopes.
  • If the app has settings, the app reads them after app.settings.updated.
  • You tested uninstall and a new install.
  • You tested with a business that is not your own, through a test link.
Last modified on November 16, 2026