ifthenpay Payments MCP
Remote MCP for ifthenpay payments: Multibanco, MB WAY and Payshop.
我该使用它吗
质量与安全性
A
基于对工具定义和协议合规性的自动分析。
上下文开销
~1,983token 数（工具定义）
~2.5 KB典型响应大小
对注意力有中等影响（占 128k 上下文窗口的 1.55%）
这是每次将服务器的工具加载到模型上下文窗口时所消耗的大致 token 数。数值越高，可用于其他任务的注意力就越少。
安装
一键安装
将以下内容添加到你的 `claude_desktop_config.json` 文件中：
{
"mcpServers": {
"payments": {
"url": "https://ai.ifthenpay.com/mcp/payments/"
}
}
}远程端点
https://ai.ifthenpay.com/mcp/payments/streamable-http它能做什么
工具清单
工具（8）
🟢 只读🟡 写入🔴 删除⚪ 未知
🟡multibanco_create_reference(mb_key, order_id, amount, expiry_days)
Creates a Multibanco payment reference that the customer can use to pay at any ATM or via online banking in Portugal.
输入模式
{
"type": "object",
"properties": {
"mb_key": {
"type": "string",
"description": "ifthenpay Multibanco key."
},
"order_id": {
"type": "string",
"description": "Unique order identifier in your system."
},
"amount": {
"type": "number",
"description": "Payment amount in EUR (e.g. 10.50)."
},
"expiry_days": {
"type": "integer",
"description": "Number of days until the reference expires. Defaults to no expiry if omitted."
}
},
"required": [
"mb_key",
"order_id",
"amount"
]
}🟢mbway_request_payment(mbway_key, order_id, amount, phone, description)
Sends an MB WAY payment request to the customer's mobile phone. The customer approves the payment in the MB WAY app. Use mbway_check_status to check the result.
输入模式
{
"type": "object",
"properties": {
"mbway_key": {
"type": "string",
"description": "ifthenpay MB WAY key."
},
"order_id": {
"type": "string",
"description": "Unique order identifier in your system (max 15 characters)."
},
"amount": {
"type": "number",
"description": "Payment amount in EUR (e.g. 10.50)."
},
"phone": {
"type": "string",
"description": "Customer mobile number in format \"351#912345678\" (country code # number)."
},
"description": {
"type": "string",
"description": "Short payment description shown in the MB WAY app."
}
},
"required": [
"mbway_key",
"order_id",
"amount",
"phone"
]
}🟢mbway_check_status(mbway_key, request_id)
Checks the status of a previously requested MB WAY payment. Returns pending, paid, declined, timeout, or cancelled.
输入模式
{
"type": "object",
"properties": {
"mbway_key": {
"type": "string",
"description": "ifthenpay MB WAY key."
},
"request_id": {
"type": "string",
"description": "Request ID returned by mbway_request_payment."
}
},
"required": [
"mbway_key",
"request_id"
]
}🟡payshop_create_reference(payshop_key, order_id, amount, expiry_date)
Creates a Payshop payment reference that the customer can use to pay at any Payshop agent or CTT (postal service) in Portugal.
输入模式
{
"type": "object",
"properties": {
"payshop_key": {
"type": "string",
"description": "ifthenpay Payshop key."
},
"order_id": {
"type": "string",
"description": "Unique order identifier in your system (max 25 characters)."
},
"amount": {
"type": "number",
"description": "Payment amount in EUR (e.g. 10.50)."
},
"expiry_date": {
"type": "string",
"description": "Expiry date in YYYYMMDD format (e.g. 20301231). Leave blank for no expiry."
}
},
"required": [
"payshop_key",
"order_id",
"amount"
]
}🟡creditcard_create_payment(ccard_key, order_id, amount, success_url, error_url, ...)
Creates a credit/debit card payment session and returns a payment URL. The customer is redirected to a hosted checkout page to complete payment with their card.
输入模式
{
"type": "object",
"properties": {
"ccard_key": {
"type": "string",
"description": "ifthenpay Credit Card key."
},
"order_id": {
"type": "string",
"description": "Unique order identifier in your system (max 15 characters)."
},
"amount": {
"type": "number",
"description": "Payment amount in EUR (e.g. 10.50)."
},
"success_url": {
"type": "string",
"description": "URL to redirect the customer after a successful payment."
},
"error_url": {
"type": "string",
"description": "URL to redirect the customer if the payment fails."
},
"cancel_url": {
"type": "string",
"description": "URL to redirect the customer if they cancel the payment."
},
"language": {
"type": "string",
"description": "Language for the checkout page (e.g. \"pt\", \"en\"). Defaults to \"pt\"."
}
},
"required": [
"ccard_key",
"order_id",
"amount",
"success_url",
"error_url",
"cancel_url"
]
}🟡pinpay_create_payment(gateway_key, order_id, amount, description, success_url, ...)
Creates a Pay by Link / PINPAY payment. Returns a shareable payment URL and a PIN code. The hosted checkout supports multiple payment methods including Credit Card, Google Pay, and Apple Pay.
输入模式
{
"type": "object",
"properties": {
"gateway_key": {
"type": "string",
"description": "ifthenpay Gateway key for Pay by Link / PINPAY."
},
"order_id": {
"type": "string",
"description": "Unique order identifier in your system (max 15 characters)."
},
"amount": {
"type": "number",
"description": "Payment amount in EUR (e.g. 10.50)."
},
"description": {
"type": "string",
"description": "Short description shown on the payment page (max 200 characters)."
},
"success_url": {
"type": "string",
"description": "URL to redirect the customer after a successful payment."
},
"error_url": {
"type": "string",
"description": "URL to redirect the customer if the payment fails."
},
"cancel_url": {
"type": "string",
"description": "URL to redirect the customer if they cancel."
},
"expiry_date": {
"type": "string",
"description": "Link expiry date in YYYYMMDD format (e.g. 20301231). Leave blank for no expiry."
},
"lang": {
"type": "string",
"description": "Language for the payment page: pt, en, es, fr. Defaults to pt."
},
"accounts": {
"type": "string",
"description": "Payment methods to show in the gateway, separated by semicolons. Format: METHOD|KEY (e.g. \"MBWAY|MBWAY-KEY;MB|MB-KEY;PAYSHOP|PAYSHOP-KEY;CCARD|CCARD-KEY\"). Leave blank to use gateway defaults."
},
"selected_method": {
"type": "string",
"enum": [
"1",
"2",
"3",
"4",
"7",
"8"
],
"description": "Pre-select a payment method: 1=Multibanco, 2=MB WAY, 3=Payshop, 4=Credit Card, 8=Pix."
},
"otp": {
"type": "string",
"enum": [
"true",
"false"
],
"description": "One-time payment: \"true\" makes the link expire after a single payment."
},
"btn_close_url": {
"type": "string",
"description": "URL for the close/back button on the payment page."
},
"btn_close_label": {
"type": "string",
"description": "Label text for the close/back button."
}
},
"required": [
"gateway_key",
"order_id",
"amount"
]
}🟡pix_create_payment(pix_key, order_id, amount, redirect_url, customer_name, ...)
Creates a PIX payment for Brazilian customers. Returns a payment URL and a QR code value. Customer must have a CPF number (Brazilian tax ID).
输入模式
{
"type": "object",
"properties": {
"pix_key": {
"type": "string",
"description": "ifthenpay PIX key."
},
"order_id": {
"type": "string",
"description": "Unique order identifier in your system (max 25 characters)."
},
"amount": {
"type": "number",
"description": "Payment amount in BRL (e.g. 50.00)."
},
"redirect_url": {
"type": "string",
"description": "URL to redirect the customer after payment. Check payment status via the status API after redirect."
},
"customer_name": {
"type": "string",
"description": "Full name of the customer (max 150 characters)."
},
"customer_cpf": {
"type": "string",
"description": "Customer CPF number (Brazilian tax ID), digits only (e.g. 74026594025)."
},
"customer_email": {
"type": "string",
"description": "Customer email address."
},
"customer_phone": {
"type": "string",
"description": "Customer phone number including country code (e.g. +5585912345678)."
},
"description": {
"type": "string",
"description": "Short description or reference for the payment (max 200 characters)."
},
"customer_address": {
"type": "string",
"description": "Customer street address."
},
"customer_city": {
"type": "string",
"description": "Customer city."
},
"customer_state": {
"type": "string",
"description": "Customer state (e.g. CE, SP)."
},
"customer_zip_code": {
"type": "string",
"description": "Customer postal/ZIP code."
}
},
"required": [
"pix_key",
"order_id",
"amount",
"redirect_url",
"customer_name",
"customer_cpf",
"customer_email",
"customer_phone"
]
}🟢payments_list(bo_key, entity, sub_entity, order_id, reference, ...)
Lists completed payments using the ifthenpay Backoffice Key. Filter by payment method, date range, order ID, reference or request ID. Returns up to 1000 most recent payments if no filters are applied.
输入模式
{
"type": "object",
"properties": {
"bo_key": {
"type": "string",
"description": "ifthenpay Backoffice Key (provided when signing the contract)."
},
"entity": {
"type": "string",
"description": "Payment method entity filter. Use: MB, MBWAY, PAYSHOP, CCARD, GOOGLE, APPLE, PIX, or a 5-digit Multibanco entity number. Leave blank for all methods."
},
"sub_entity": {
"type": "string",
"description": "Payment method key or sub-entity (e.g. MB KEY, MBWAY KEY, PAYSHOP KEY). Leave blank to match all."
},
"order_id": {
"type": "string",
"description": "Filter by order identifier."
},
"reference": {
"type": "string",
"description": "Filter by payment reference (Multibanco/Payshop reference or orderId for other methods)."
},
"request_id": {
"type": "string",
"description": "Filter by the unique request token returned at payment creation."
},
"amount": {
"type": "string",
"description": "Filter by exact payment amount."
},
"date_start": {
"type": "string",
"description": "Start date/time in format dd-MM-yyyy HH:mm:ss (e.g. 01-01-2024 00:00:00)."
},
"date_end": {
"type": "string",
"description": "End date/time in format dd-MM-yyyy HH:mm:ss (e.g. 31-01-2024 23:59:59)."
}
},
"required": [
"bo_key"
]
}社区
证据
最近观测
已验证未记录版本8 个工具
已验证未记录版本8 个工具