# Afterpay MCP for AI Agents AI Agent Connect

> Afterpay MCP. Manage your BNPL checkouts, payments, and refunds through your AI agent. It handles the heavy lifting of merchant account tasks like creating tokens and auditing transaction limits so you don't have to jump between tabs.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_sQRk8dKNgiA5Z2tujCBpqrjbpknJsvMYe9uyLv35/ai-agent-connect
- **Tags:** buy-now-pay-later, checkout-sessions, refund-processing, payment-status, merchant-services, financial-transactions

## Description

Running an e-commerce store with 'Buy Now, Pay Later' options adds a layer of complexity to your daily operations. You have to balance a smooth customer experience with the technical side of managing BNPL transactions. This Connector changes that by giving your AI agent direct access to your Afterpay merchant account. Instead of jumping between browser tabs to verify a payment or hunting through a dashboard to issue a refund, you can just talk to your agent. You can start new checkout sessions for customers, pull settlement logs for specific orders, and check your merchant's transaction limits on the fly. It turns a multi-step manual process into a single conversation. Whether you are a support lead trying to clear a billing dispute, a finance manager auditing transaction history, or a developer checking API responses, this tool puts the data where you actually work. It's a practical way to handle the financial side of your business without the usual friction of manual data entry or dashboard fatigue. You can find this connector along with over 4,000 others in the Vinkius catalog to keep your stack connected and your workflow moving.

## Tools

### get_afterpay_config
Retrieve the minimum and maximum order transaction limits for your merchant account. This keeps you informed on your current spending caps.

### list_payments
Retrieve historical BNPL transactions and authorizations securely from your account. Use this to see a full audit of your payment history.

### get_payment_details
Retrieve detailed financial status, settlement info, and logs for a specific order. This helps you see exactly when a payment was captured.

### refund_payment
Initiate a full or partial refund to credit a consumer against a previously captured order. Always verify the balance before you run this.

### create_checkout
Initiate a secure Afterpay BNPL payment session token for a new customer transaction. This starts the payment flow for your shoppers.

## Prompt Examples

**Prompt:** 
```
Create a checkout for $150.
```

**Response:** 
```
I've started the session for $150.00. Here is your checkout token and the redirect link for the customer:

**Token:** `abc123xyz` 
**Redirect URL:** https://portal.afterpay.com/checkout/...
```

**Prompt:** 
```
What's the status of order 998877?
```

**Response:** 
```
I've pulled the details for order 998877:

*   **Status:** APPROVED
*   **Capture Date:** March 30th
*   **Settlement Info:** Completed

Would you like me to pull the full logs for this transaction?
```

**Prompt:** 
```
What are our current order limits?
```

**Response:** 
```
I've checked your merchant configuration:

*   **Minimum Order:** $1.00
*   **Maximum Limit:** $2,000.00

These limits are currently active for both US and Canada regions.
```

## Capabilities

### Create checkout tokens
Generate secure BNPL payment session tokens for new customer transactions.

### Pull payment history
Retrieve a list of historical BNPL transactions and authorizations from your account.

### Issue refunds
Process full or partial refunds to credit a consumer against a captured order.

### Check transaction limits
View the minimum and maximum order limits enforced by your merchant account.

### View settlement details
Get detailed financial status and logs for a specific order ID.

## Use Cases

### Handling a refund request
A customer asks for a partial refund on a recent order. The support agent uses `refund_payment` to issue the credit immediately.

### Verifying merchant limits
An e-commerce manager needs to know the max order limit for a new promotion. They ask the agent to use `get_afterpay_config`.

### Checking payment status
A customer calls about a pending order. The agent uses `get_payment_details` to confirm the capture status and settlement info.

### Starting a new sale
A store owner wants to create a checkout for a $500 item. The agent uses `create_checkout` to generate a secure token.

## Benefits

- Faster refunds: Use `refund_payment` to issue credits instantly without manual dashboard navigation.
- Real-time monitoring: Use `list_payments` to see every transaction status as it happens.
- Accurate auditing: Use `get_payment_details` to see settlement info and logs for any order.
- Limit visibility: Use `get_afterpay_config` to see your transaction caps across all regions.
- Seamless checkouts: Use `create_checkout` to start new buyer sessions with secure tokens.

## How It Works

The bottom line is you get to manage your entire Afterpay merchant workflow through a chat interface instead of a dashboard.

1. Enter your Afterpay Merchant ID and Secret Key into your Connector configuration.
2. Connect the Connector to your preferred AI client like Claude or Cursor.
3. Ask your agent to list payments, create checkouts, or issue refunds.

## Frequently Asked Questions

**Can I use Afterpay MCP to refund customers?**
Yes, you can use it to issue full or partial refunds directly. Your agent will handle the request and credit the consumer against a captured order.

**Does Afterpay MCP work for both Clearpay and Afterpay?**
Yes, it supports both merchant brands. You can manage transactions and checkouts for either service through the same interface.

**How do I see my transaction limits with Afterpay MCP?**
You can simply ask your agent to check your merchant configuration. It will pull the minimum and maximum order limits for your account instantly.

**Can I check if a payment was successful using Afterpay MCP?**
Yes, your agent can pull specific payment details. It will show you the capture status, settlement info, and other technical logs for any order ID.

**Is Afterpay MCP good for high-volume stores?**
Yes, it is built for enterprise-grade BNPL orchestration. It helps high-volume merchants manage checkouts and payment monitoring without manual dashboard fatigue.

**How do I find my Afterpay Merchant credentials?**
Log in to your Afterpay Merchant Portal, go to **Settings** > **API**. You can generate and retrieve your **Merchant ID** and **Secret Key** there. Make sure to choose the correct region (US, AU, UK).

**Can I process a partial refund via the agent?**
Yes! Use the `refund_payment` tool and provide the `orderId` and the specific amount. Your agent will submit the partial refund request to Afterpay for processing.

**What is the difference between Capture and Auth?**
'Capture' finalizes the payment immediately. 'Auth' (Authorization) holds the funds on the customer's account, and you must call the capture tool later (usually when shipping) to finalize the transaction.