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 #.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.
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.