# Dola Checkout MCP MCP

> Dola Checkout connects your AI agent directly to global e-commerce transactions. It handles everything from creating secure checkout links for digital products and subscriptions to tracking payment status in real time. Manage orders, shopper profiles, and webhooks through natural conversation.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** checkout-optimization, e-commerce, payment-gateway, order-fulfillment, conversion-rate, transaction-tracking

## Description

You can give your AI agent full control over your entire sales cycle. Instead of logging into a dashboard to track payments or generate URLs, you just ask your agent what you need. It handles the complexity behind the scenes, giving you instant access to shopper history, payment status, and merchant data.

Need to set up a new sale? Your agent can run the `create_checkout` tool, generating a secure link for a specific product right away. When the purchase happens, it doesn't stop there; your agent monitors everything, using tools like `list_orders` to pull up all transactions and tell you which ones are pending or completed. You even get visibility into who bought the item by pulling up full shopper profiles with the `get_customer` tool. If anything changes—like a payment webhook firing—your agent can manage that data sync for you, so you never lose track of an order. It makes your e-commerce operations feel like chatting with a dedicated payments coordinator, accessible right through any MCP-compatible client on Vinkius.

## Tools

### create_checkout
Builds a new session and generates a secure link for a customer to pay.

### create_order
Initializes a brand new order record in the system.

### create_webhook
Sets up a reliable, real-time data sync hook for specific events.

### get_account_info
Retrieves general information about your main merchant account profile.

### get_checkout
Gets the current status and details for a specific checkout session.

### get_customer
Pulls up all available details about a single shopper ID.

### get_order
Retrieves the complete record and status for one specific order number.

### list_checkouts
Provides an overview of all currently active checkout sessions.

### list_customers
Lists basic details and IDs for every registered customer account.

### list_orders
Retrieves a list of all past and active orders in the system.

### list_webhooks
Shows an index of all webhooks that are currently configured.

### update_order
Changes the status or details for a specific existing order record.

## Prompt Examples

**Prompt:** 
```
List all active checkout orders in my Dola account.
```

**Response:** 
```
I've retrieved your recent orders. You currently have 5 active transactions, including Order #4502 (Completed) and #4503 (Pending). Would you like the shopper details for any of these?
```

**Prompt:** 
```
Create a checkout session for a 'MacBook Pro' priced at $1999.00.
```

**Response:** 
```
Checkout session generated! I've created a new session for the MacBook Pro. You can share this secure URL with the customer: [checkout_url]. The session ID is 'sess_123'.
```

**Prompt:** 
```
Show the purchase history for shopper ID 'cust_789'.
```

**Response:** 
```
Fetching history... Shopper cust_789 has made 3 past purchases totaling $2,450. Notable orders include a 'Workstation' and 'Monitor Stand'. Shall I check the fulfillment status for their latest order?
```

## Capabilities

### Process new sales and checkout links
Generate secure payment URLs for specific products or create an entirely new order session.

### Track payments and orders
List all active transactions, retrieve detailed status reports on any given order, and update its current state.

### Manage customer data
Pull up complete shopper profiles and monitor their purchase history using a single request.

### Automate system connections
Configure and manage real-time webhooks, ensuring your systems process transaction data reliably.

### Get account visibility
Access high-level merchant metadata and sales summaries without leaving your agent chat.

## Use Cases

### The Customer Service Inquiry
A customer calls asking about a purchase from last month. Instead of forcing them to email screenshots, the agent uses `list_orders` and then `get_order` with the order number to confirm payment status and find the product details.

### The Marketing Campaign Launch
A manager needs 50 checkout links for a flash sale. They prompt their agent, which uses `create_checkout` repeatedly, generating all necessary secure URLs in seconds so they can distribute them instantly via email.

### The Tech Audit
The ops team needs to verify if payment webhooks are firing correctly after a major update. They use `list_webhooks` and then `create_webhook` to ensure the necessary data sync points are in place.

## Benefits

- Stop manually searching for orders. With `list_orders`, you get an instant, comprehensive list of all past and active transactions right in the chat window.
- No more guessing which shopper needs help. You can pull up full profiles using `get_customer` to see their entire purchase history instantly.
- Need a payment link for a campaign? Use `create_checkout` to generate secure URLs on demand, without logging into any external website.
- Keep your data clean and synced. Managing webhooks via `create_webhook` means you can reliably process payments even when systems are talking asynchronously.
- Operational reporting is simple. Accessing account details with `get_account_info` gives you instant sales summaries for quick business checks.

## How It Works

The bottom line is your AI acts as a dedicated e-commerce coordinator, eliminating manual dashboard work entirely.

1. Subscribe to this MCP and grab your Secret API Key from your Dola dashboard.
2. Connect that key in your preferred AI client, giving your agent permission to manage payments on your behalf.
3. Ask the agent for what you need. It uses its tools to talk directly to Dola Checkout and returns the data or action result.

## Frequently Asked Questions

**How do I list all active orders using the Dola Checkout MCP?**
Run `list_orders` to get a full rundown. This tool gives you an index of every checkout order, letting you quickly identify which ones are pending or completed.

**Can I use the create_checkout tool for subscriptions?**
Yes. The `create_checkout` tool handles complex products, including generating sessions designed for recurring payments and digital goods.

**What is the best way to track payment status after a sale? (get_order)**
`get_order` retrieves the complete record. You can use it to confirm if an order has been paid, what stage it's in, and when it was last updated.

**Do I need to manually manage webhooks? (create_webhook)**
No. Using `list_webhooks` shows you what’s running, and the agent can configure or update them for you with `create_webhook`, automating your data flow.

**How do I check my Dola Checkout account status using the `get_account_info` tool?**
You retrieve your basic merchant profile and connectivity details instantly. This confirms that your API key is active and properly linked to the Dola platform, ensuring reliable operation before running complex transactions.

**When I use `get_customer`, what specific purchase history details can my agent retrieve?**
The tool provides a complete shopper profile. You'll get total past purchases, notable items bought, and the count of orders associated with that customer ID for deep record keeping.

**How can I manually change an order status using the `update_order` tool?**
You tell your agent exactly which order needs updating and what the new status is. This allows you to mark items as shipped or canceled without needing to log into the Dola dashboard.

**What does the `list_webhooks` tool show regarding my active data syncs?**
It lists every webhook configured for your account. You can quickly verify which events are being monitored and ensure no critical transaction streams have been accidentally deactivated or lost.

**How do I find my Dola Secret API Key?**
Log in to your Dola dashboard, navigate to **Settings** > **API**, and copy your Secret API Key displayed there.

**Can I generate a checkout URL for a specific cart?**
Yes! Use the `create_checkout` tool and provide a JSON string containing the cart items to generate a 1-click payment session.

**How do I check a customer's purchase history?**
Use the `get_customer` tool with a customer ID to retrieve their profile and a detailed log of all their past Dola transactions.