# Durianpay MCP MCP

> Durianpay helps your AI agent manage complex payment operations instantly. You can track every checkout order, pull detailed reports on transactions, list failed payments for reconciliation, and get a high-level audit of your revenue health—all using natural conversation.

## Overview
- **Category:** finance-accounting
- **Price:** Free
- **Tags:** payment-gateway, checkout-flow, settlements, transaction-tracking, payment-links, fintech

## Description

Stop switching between dashboards to reconcile finances. This MCP connects Durianpay's core platform directly into your AI workflow, letting you handle everything from incoming payments to final settlements through plain language commands. Instead of manually running reports and piecing together data points, you talk to your agent, and it pulls the necessary information for you. Need to check if a customer's profile is linked to an old payment? Done. Want to see which orders are sitting in 'Awaiting Payment'? No problem. If you're connecting this via Vinkius, you get access to over 4,000 financial tools, meaning your agent can handle more than just payments—it’s a single point of control for all your business data.

## Tools

### get_durianpay_account_metadata
Retrieves the usage limits and general metadata for your Durianpay account.

### get_payment_order_details
Retrieves granular details for a single checkout order ID.

### get_payment_details
Gets complete information, including lifecycle status, for one specific payment ID.

### quick_revenue_health_audit
Generates a high-level summary of payment activity, showing success rates and general trends.

### list_registered_customers
Provides a list of every customer profile registered within the organization.

### list_failed_transactions
Identifies and lists payments that were declined or failed for reconciliation purposes.

### list_payment_orders
Lists all checkout orders that have been created in your Durianpay account.

### list_durianpay_payments
Lists every payment successfully received in your Durianpay account.

### list_latest_transactions
Shows the most recently received payments, useful for daily reporting checks.

### search_payment_orders
Searches for specific checkout orders using either an order ID or a customer name keyword.

## Prompt Examples

**Prompt:** 
```
List the latest payments received.
```

**Response:** 
```
I've found 5 recent payments, including IDR 150,000 from 'John Doe' and IDR 500,000 from 'Alice Smith'. All are currently 'Completed'. Would you like to see the payment method for any of these?
```

**Prompt:** 
```
Show me the details for order 'ORD-9988'.
```

**Response:** 
```
Order 'ORD-9988' is currently 'Awaiting Payment'. It contains 2 items with a total amount of IDR 750,000. The checkout link expires in 2 hours. Should I pull the customer contact information?
```

**Prompt:** 
```
Check for any failed transactions today.
```

**Response:** 
```
I've identified 2 failed payments today: one declined by the bank (IDR 200,000) and one expired checkout. Would you like me to pull the detailed error codes for the declined payment?
```

## Capabilities

### Review Payment History
Retrieve detailed records and the current status for any transaction in your Durianpay account.

### Monitor Checkout Statuses
Get full details on specific checkout orders, including line items and expiration dates.

### Audit Revenue Health
Instantly pull a high-level summary of payment activity, success rates, and failed transactions without needing complex queries.

### Manage Customer Data
List registered customer profiles and their overall transaction history within your organization.

## Use Cases

### Daily Reconciliation Check
The finance manager needs to know if anything went wrong overnight. They ask their agent to use list_latest_transactions and quick_revenue_health_audit, getting a summary of success rates and any recent failures in minutes.

### Investigating a Billing Dispute
A customer claims they paid but the payment isn't showing up. The support team uses list_registered_customers to find the user, then calls get_payment_details with the transaction ID to pull proof of payment.

### Checking for Stale Orders
The e-commerce lead needs to check if any checkout orders are about to expire. They use list_payment_orders, then search_payment_orders to find all open links that need immediate attention.

### Audit Trail Cleanup
A junior analyst needs to see all payments from a specific week and also identify any payments that failed. They run list_durianpay_payments, followed by list_failed_transactions for comprehensive reporting.

## Benefits

- Never miss a payment detail. You can use get_payment_details to pull up the full life cycle status of any single transaction, whether it's pending or completed.
- Stop worrying about expired links. list_payment_orders lets you list and search all checkout orders using order ID or customer names via search_payment_orders.
- Quickly reconcile finances by running quick_revenue_health_audit to get a success rate summary without writing complex SQL queries.
- Support teams can now use list_registered_customers to pull up a customer's full history, drastically speeding up billing inquiries.
- You won't forget the bad payments. Running list_failed_transactions immediately identifies which payments were declined or failed for follow-up action.

## How It Works

The bottom line is that your AI client handles all the complex API calls so you just get a clear answer in conversation.

1. Connect this MCP to your preferred AI client, then authorize it using your Durianpay Secret API Key.
2. Ask your agent a specific question, like 'Show me the failed transactions from yesterday,' or 'What's the status of order ORD-123.'
3. The agent executes the necessary tool calls and returns plain text answers summarizing payment data, customer details, and revenue summaries.

## Frequently Asked Questions

**How do I check for failed payments with Durianpay MCP?**
You use the list_failed_transactions tool. This immediately tells you which payments were declined or failed, allowing you to track down the specific error code needed for reconciliation.

**Can I find a customer's payment history using Durianpay MCP?**
Yes, you can list_registered_customers to get the profile list. Then your agent uses that data in conjunction with listing payments to build out the full transaction view.

**Which tool do I use for current revenue reports? (quick_revenue_health_audit)**
Use quick_revenue_health_audit. This provides a high-level, instant summary of payment activity and success rates without requiring you to write complex filtering logic.

**How do I check the status of an order? (get_payment_order_details)**
You call get_payment_order_details with the specific order ID. This provides all the necessary information, including line items and how much time is left before the payment link expires.

**How do I check my usage limits or account health using the `get_durianpay_account_metadata` tool?**
It retrieves your metadata and current operational limits for the Durianpay account. This tells you exactly what capacity remains for processing payments, helping prevent service interruptions due to overages.

**If I only know a customer's name or partial order ID, how do I use `search_payment_orders`?**
You can search for orders using keywords like the customer’s name or part of an ID. This is much faster than listing every single order and filtering it manually.

**How do I get a complete record of all payments in my account history using `list_durianpay_payments`?**
This function lists every payment received across your entire Durianpay account. It’s perfect for comprehensive audits or when you need to track transactions that happened long ago.

**What specific lifecycle details does `get_payment_details` provide about a single transaction?**
It gives granular information and the full status of one payment. You can confirm if it’s pending, settled, or get detailed reasons why a specific payment failed.

**How do I get a Durianpay API Key?**
Log in to your Durianpay dashboard, navigate to **Settings > API Keys**, and you can find your unique Secret API Key there. Ensure you use the live key for production data.

**Can the agent initiate refunds?**
This integration currently focuses on listing and auditing payments and orders. Processing refunds should be managed via the Durianpay dashboard or specific refund API endpoints.

**Which payment methods are tracked?**
Durianpay tracks various methods including Virtual Accounts, E-wallets, Credit Cards, and Retail outlets. The agent can retrieve the specific method used for each transaction.