Back to Templates

Connect AI Agents to Beanstream Payments API for Payment Processing & Management

Created by

Created by: David Ashby || cfomodz

David Ashby

Last update

Last update 5 days ago

Share


Complete MCP server exposing 15 Beanstream Payments API operations to AI agents.

⚡ Quick Setup

  1. Import this workflow into your n8n instance
  2. Credentials Add Beanstream Payments credentials
  3. Activate the workflow to start your MCP server
  4. Copy the webhook URL from the MCP trigger node
  5. Connect AI agents using the MCP URL

🔧 How it Works

This workflow converts the Beanstream Payments API into an MCP-compatible interface for AI agents.

MCP Trigger: Serves as your server endpoint for AI agent requests
HTTP Request Nodes: Handle API calls to https://www.beanstream.com/api/v1
AI Expressions: Automatically populate parameters via $fromAI() placeholders
Native Integration: Returns responses directly to the AI agent

📋 Available Operations (15 total)

🔧 Payments (5 endpoints)

POST /payments: Make Payment
GET /payments/{transId}: Get payment
POST /payments/{transId}/completions: Complete pre-auth
POST /payments/{transId}/returns: Return payment
POST /payments/{transId}/void: Void Transaction

🔧 Profiles (8 endpoints)

POST /profiles: Create Profile
DELETE /profiles/{profileId}: Delete profile
GET /profiles/{profileId}: Get profile
PUT /profiles/{profileId}: Update Profile
GET /profiles/{profileId}/cards: Get cards
POST /profiles/{profileId}/cards: Add card
DELETE /profiles/{profileId}/cards/{cardId}: Delete card
PUT /profiles/{profileId}/cards/{cardId}: Update card

🔧 Reports (1 endpoints)

POST /reports: Search Query

🔧 Scripts (1 endpoints)

POST /scripts/tokenization/tokens: Tokenize credit card

🤖 AI Integration

Parameter Handling: AI agents automatically provide values for:
• Path parameters and identifiers
• Query parameters and filters
• Request body data
• Headers and authentication

Response Format: Native Beanstream Payments API responses with full data structure

Error Handling: Built-in n8n HTTP request error management

💡 Usage Examples

Connect this MCP server to any AI agent or workflow:

Claude Desktop: Add MCP server URL to configuration
Cursor: Add MCP server SSE URL to configuration
Custom AI Apps: Use MCP URL as tool endpoint
API Integration: Direct HTTP calls to MCP endpoints

✨ Benefits

Zero Setup: No parameter mapping or configuration needed
AI-Ready: Built-in $fromAI() expressions for all parameters
Production Ready: Native n8n HTTP request handling and logging
Extensible: Easily modify or add custom logic

🆓 Free for community use! Ready to deploy in under 2 minutes.