> ## Documentation Index
> Fetch the complete documentation index at: https://docs.dodopayments.com/llms.txt
> Use this file to discover all available pages before exploring further.

# Raycast Extension

> Install the Dodo Payments Raycast extension to browse payments, subscriptions, customers, products, and refunds from your keyboard on macOS.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/dodo-payments-commands.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=4bf25ee9eaa63ae8f4eadbcd3c61ce48" alt="Raycast extension home showing Dodo Payments commands" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/dodo-payments-commands.png" />
</Frame>

The Dodo Payments extension for Raycast puts your dashboard a few keystrokes away. Use it to view payments, subscriptions, customers, products, discount codes, license keys, and refunds without opening the dashboard.

## Install

<Card title="Install from Raycast Store" icon="puzzle-piece" href="https://www.raycast.com/dodopayments/dodo-payments">
  Open the Dodo Payments extension page in the Raycast Store.
</Card>

<Info>
  The extension requires Raycast on macOS and a Dodo Payments API key.
</Info>

## Setup

<Steps>
  <Step title="Get Your API Key">
    1. Log in to your Dodo Payments dashboard.
    2. Go to **Developer → API Keys** and click **Add API Key**.
    3. Copy the new key. The dashboard shows it only once.

    Create the key in the mode you plan to use in Raycast. A test mode key works only in test mode.
  </Step>

  <Step title="Configure the Extension">
    1. Open Raycast.
    2. Search for "Dodo Payments" and select any command.
    3. When prompted, enter your key in the **API Key** field.
    4. In **API Mode**, choose a mode. The default is **Live**.
       * **Test**: for development and testing.
       * **Live**: for production data.
    5. Save the settings.
  </Step>
</Steps>

<Tip>
  Start in **Test** mode to check your setup, then switch to **Live**.
</Tip>

<Warning>
  Treat your API key like a password. Don't share it or store it in plain text.
</Warning>

## Use the Extension

* **Search**: open Raycast, type "Dodo Payments", and pick a command.
* **Filter**: narrow results by typing part of an ID, email address, name, or status.
* **Open details**: press Enter on a list item to see more information.

## Commands and Views

Each view below is a separate Raycast command, such as **View Payments** or **View Refunds**.

### Payments

Browse recent payments and open their details.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/view-payments.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=b3f7a7f1b52dd7cc12092c0b97fffcc8" alt="Payments list view in the Raycast extension" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/view-payments.png" />
</Frame>

### Subscriptions

Scan active, on-hold, and cancelled subscriptions.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/view-subscriptions.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=efdcb47236aa8717d7d5256b1ba271d2" alt="Subscriptions list view in the Raycast extension" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/view-subscriptions.png" />
</Frame>

### Customers

Find customers and open their full profiles.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/view-customers.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=c2e7b2cdf47e128f4b4a200ccbb06c9c" alt="Customers list view in the Raycast extension" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/view-customers.png" />
</Frame>

### Products

Review and manage your product catalog at a glance.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/view-products.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=973cf1ac1bd6cd4b97bf28bcaa93e09e" alt="Products list view in the Raycast extension" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/view-products.png" />
</Frame>

### Discount Codes

Search your active discount codes and look up their details.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/view-discount-codes.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=51c0d034428ad81397b5df52ddf1d224" alt="Discount codes list view in the Raycast extension" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/view-discount-codes.png" />
</Frame>

### License Keys

Look up and manage license keys without leaving Raycast.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/view-license-keys.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=11a4eff6666ea52a12e80c66201d0120" alt="License keys list view in the Raycast extension" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/view-license-keys.png" />
</Frame>

### Refunds

See recent refunds and open their details.

<Frame>
  <img src="https://mintcdn.com/dodopayments/slbAEdrLLwKHfaRf/images/integrations/raycast/view-refunds.png?fit=max&auto=format&n=slbAEdrLLwKHfaRf&q=85&s=a1600d565ff683d738ec27a675e23c30" alt="Refunds list view in the Raycast extension" style={{ maxHeight: '500px', width: 'auto' }} width="2000" height="1250" data-path="images/integrations/raycast/view-refunds.png" />
</Frame>

<Info>
  The extension also has **View Disputes** and **View Payouts** commands. Payouts exist only in live mode, so **View Payouts** shows data only when **API Mode** is **Live**.
</Info>

## Troubleshooting

<AccordionGroup>
  <Accordion title="Authentication Failed or 401/403 Errors">
    Check that the API key and the **API Mode** setting (Test or Live) match the mode where you created the key. Reopen the command and enter the key again if needed.
  </Accordion>

  <Accordion title="No Results Appear">
    Check that the selected mode has data. Try switching between Test and Live.
  </Accordion>

  <Accordion title="Rate Limits or Timeouts">
    Wait a moment and try again. If the issue persists, check your network connection.
  </Accordion>
</AccordionGroup>

<Card title="Need Help? Contact Support" icon="life-ring" href="/miscellaneous/help-support">
  Get help from the Dodo Payments team.
</Card>


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.