# Dodo Payments setup for PopMCP

You paste one Dodo Payments API key into PopMCP, plus the word "test" or "live" in the Environment box to say which mode that key belongs to.

- Auth: API credentials
- Setup time: 3 min
- API base URL: https://live.dodopayments.com (test mode: https://test.dodopayments.com)
- Credentials screen: https://app.dodopayments.com/
- Provider docs: https://docs.dodopayments.com/api-reference/introduction

## Approval required before this works

Dodo Payments' compliance team must approve your merchant account (identity, business and bank verification) before live-mode keys can take real payments or pay out.

- Typical wait: Docs state typical verification time of 1-3 business days (excluding weekends and public holidays), and that most reviews finish within 72 hours; appeals are quoted at more than 48 working hours
- Cost: Free
- Blocked until approved: Live payments and payouts. A live-mode API key exists from day one, but until verification is approved the account cannot accept real charges and no money can be paid out to your bank account.
- Works meanwhile: The test-mode API key works immediately at signup - full integration, products, subscriptions, licence keys, webhooks and the CLI/MCP tooling all run against test mode with no review.

## Before you begin

- Dodo Payments merchant account with access to the business dashboard
- Account Verification completed if you want a live-mode key that can move real money. Test mode works from day one.

## Get your credentials

### 1. Pick the mode you want a key for

Open `app.dodopayments.com` and use the mode switch at the bottom of the left sidebar to put the dashboard in Test mode or Live mode.

Screen: https://app.dodopayments.com/

### 2. Open Developer, then API Keys

In the left sidebar click Developer, then API Keys.

### 3. Add a key and grant write access

Click Add API Key, name it `PopMCP`, and leave Enable write access ticked. Click Create.

### 4. Copy the key before you close the dialog

Click Copy, paste the key into PopMCP's API key field, then click Done.

### 5. Tell PopMCP which mode the key is in

In PopMCP type `test` in Environment for a Test Mode key, or `live` for a Live Mode key. Leaving it blank defaults to live.

## Fields PopMCP asks for

- API key (apiKey) [required]: Dodo dashboard → Developer → API Keys. Use a test-mode key for the sandbox or a live-mode key for production. Stored encrypted; used server-side only. The connection is locked to this key's account.
- Environment (environment): Type "test" if you pasted a test-mode (sandbox) key, or "live" for a production key. Defaults to live. If the mode does not match the key, we tell you which one to use.

## Verify

PopMCP shows the Dodo Payments connector as Connected with the business name and the mode it detected. Asking for your recent payments returns real payment IDs such as pay_… from that environment.

## Troubleshooting

### 401 Unauthorized on every call

Cause: The key was revoked, mistyped, or belongs to the other mode. Test keys are rejected by live.dodopayments.com and live keys by test.dodopayments.com.

Fix: Re-copy the key from Developer, API Keys, and make sure the Environment field says the same mode the dashboard was in when you created it.

### 403 on anything that creates or changes data

Cause: The key was created with Enable write access unchecked, so it is read-only.

Fix: Create a new key with Enable write access ticked and swap it into PopMCP.

### You lost the key before copying it

Cause: Dodo displays the full key only in the creation dialog.

Fix: Delete the key from Developer, API Keys, and create a replacement.

### Live payments fail even though the key works

Cause: Live Mode is available immediately, but real payments and payouts only switch on after Account Verification.

Fix: Finish the verification flow in the dashboard, or use a test-mode key until it clears.

### 429 Too Many Requests

Cause: Default Tier 0 limits are 40 requests per second and 240 per minute.

Fix: Slow the request rate and watch the X-RateLimit-Remaining and X-RateLimit-Reset headers, or ask Dodo support about a higher tier.

---

Source: https://www.docs.popmcp.com/docs/integrations/dodo-payments/