mcp-adyen

Name: mcp-adyen
Author: codespar

本地服务

github.com/codespar金融数据2754 周前更新

代码仓库

关于 mcp-adyen

@codespar/mcp-adyen 是 Adyen Checkout API v71 的 MCP 服务，面向需要在巴西、欧盟、美国和亚太地区使用同一合同处理支付的企业商户。它提供支付、退款、支付链接、争议处理及余额账户等工具。

主要功能

01覆盖 Checkout API v71 的支付全流程
02支持捕获、取消、退款与金额更新
03提供支付链接与存储支付方式管理
04包含争议处理相关工具
05支持 test 与 live 环境切换

适用场景

01由智能体为企业商户创建与管理支付
02处理延迟捕获与酒店、小费等金额调整场景
03通过 MCP 处理争议申诉与抗辩材料提交

MCP 相关

该项目是一个 MCP 服务，向 MCP 客户端暴露 Adyen Checkout 与争议等 API 的工具，支持 stdio 与 HTTP 两种运行方式。

配置

本地服务的配置在各客户端中通用，复制后粘贴到客户端的 MCP 配置文件即可。

mcp.json · 通用配置

{
  "mcpServers": {
    "codespar-mcp-adyen": {
      "command": "npx",
      "args": [
        "-y",
        "@codespar/mcp-adyen"
      ],
      "env": {
        "ADYEN_API_KEY": "<ADYEN_API_KEY>",
        "ADYEN_MERCHANT_ACCOUNT": "<ADYEN_MERCHANT_ACCOUNT>",
        "ADYEN_ENV": "<ADYEN_ENV>",
        "ADYEN_LIVE_URL_PREFIX": "<ADYEN_LIVE_URL_PREFIX>"
      }
    }
  }
}

启动命令npx -y @codespar/mcp-adyen

需要配置的环境变量

ADYEN_API_KEY密钥Adyen API key (generated in Customer Area → Developers → API credentials)

ADYEN_MERCHANT_ACCOUNTAdyen merchant account code (appears in most request bodies)

ADYEN_ENVtest | live. Defaults to test.

ADYEN_LIVE_URL_PREFIXRequired when ADYEN_ENV=live. Your merchant-specific prefix, e.g. 1797a841fbb37ca7-AdyenDemo

本地服务需要在你的电脑上安装运行环境（如 Node.js 18+）。各客户端的配置文件位置不同，请参考客户端文档。

安装包

npm@codespar/mcp-adyen0.2.2stdio

工具

收录的工具列表 · 更新于 2 周前

参数	类型	必填	说明
amount	object	是	{ value: integer (minor units), currency: ISO-4217 }
origin	string	否	在 Web 上使用原生 3DS2 时必填
channel	enum	否	iOS \| Android \| Web
reference	string	是	商户端参考编号（显示在报告中）
returnUrl	string	是	3DS／银行流程完成后的重定向目标
shopperIP	string	否
browserInfo	object	否	用于 3DS2 的浏览器指纹对象
countryCode	string	否	ISO-3166 alpha-2（BR、MX 等）
shopperEmail	string	否
paymentMethod	object	是	特定支付方式的负载（银行卡使用 type=scheme，iDEAL 使用 type=ideal 等）。优先使用 onSubmit 中的令牌化字段。
shopperLocale	string	否	例如 pt-BR
additionalData	object	否
merchantAccount	string	否	覆盖 env 中的商户账户（少见）
shopperReference	string	否	稳定的购物者 ID，用于找回已存储的付款方式
storePaymentMethod	boolean	否	保存此付款方式，以便日后一键重复使用
recurringProcessingModel	enum	否	CardOnFile \| Subscription \| UnscheduledCardOnFile

详细介绍

@codespar/mcp-adyen

适用于 Adyen Checkout API v71 的 MCP 服务——这是一条全球企业级支付通道，iFood、Uber、Spotify 和 AirBnB 在拉美均有使用。

它与目录中的所有其他服务都不同：当一份合同必须覆盖巴西、欧盟、美国和亚太地区时，企业商户会选择这个网关。

工具（25）

工具	用途
`create_payment`	创建支付。
`payment_details`	提交支付的附加信息（3DS 挑战响应、重定向 returnUrl 负载等）。
`capture_payment`	扣取已授权的支付款项（适用于延迟扣款流程）。
`cancel_payment`	取消已授权但尚未扣取的支付。
`refund_payment`	退还已扣取的支付款项（全额或部分退款）。
`reverse_payment`	原子性地撤销或退款一笔支付。
`update_amount`	更新未结算支付的授权金额（常用于小费和酒店杂费）。
`get_payment_methods`	根据国家/地区、货币和金额组合，动态列出可用支付方式。
`create_payment_link`	创建托管支付链接（发送给客户的 URL）。
`get_payment_link`	按 ID 获取支付链接。
`update_payment_link`	更新支付链接，通常用于提前使其失效。
`create_donation`	创建与原始支付关联的凑整捐款（Adyen Giving）。
`list_stored_payment_methods`	列出购物者保存的支付方式（便于一键复用）。
`disable_stored_payment_method`	删除已保存的支付方式（购物者选择退出）。
`create_session`	创建 Checkout 会话（Drop-in 和 Web Components 用于加载支付方式并处理完整客户端流程……
`get_session`	获取 Checkout 会话的状态/结果（购物者完成 Drop-in 后轮询）。
`retrieve_applicable_defense_reasons`	列出 Adyen 对特定争议接受的抗辩理由代码（Dispute Service v30）。
`accept_dispute`	接受争议——放弃款项并结案（Dispute Service v30）。
`defend_dispute`	使用适用的抗辩理由代码之一为争议辩护（Dispute Service v30）。
`supply_defense_document`	为正在进行的争议抗辩上传支持文件（Dispute Service v30）。
`list_balance_accounts`	列出账户持有人拥有的余额账户（Balance Platform BCL v2）。
`get_balance_account`	按 ID 获取单个余额账户（Balance Platform BCL v2）。
`create_transfer`	从余额账户发起转账（银行付款、内部划转、向第三方银行卡转账）（Transfers B...
`get_transfer`	按 ID 获取转账（Transfers BTL v4）。
`list_merchants`	列出 API 凭据可见的商户账户（Management API v3）。

安装

npm install @codespar/mcp-adyen

环境

ADYEN_API_KEY="..."              # X-API-Key value, secret
ADYEN_MERCHANT_ACCOUNT="..."     # Merchant account code injected into every call
ADYEN_ENV="test"                 # test | live. Default: test.
ADYEN_LIVE_URL_PREFIX="..."      # Required when ADYEN_ENV=live. Your merchant-specific prefix from Customer Area.

URL 路由

ADYEN_ENV=test → https://checkout-test.adyen.com/v71
ADYEN_ENV=live → https://<ADYEN_LIVE_URL_PREFIX>-checkout-live.adyenpayments.com/checkout/v71

如果缺少 ADYEN_LIVE_URL_PREFIX，线上调用会立即失败。

运行

# stdio (default)
npx @codespar/mcp-adyen

# HTTP
MCP_HTTP=true MCP_PORT=3000 npx @codespar/mcp-adyen

范围

此 v0.1 版本仅涵盖 Checkout API v71。当出现需求时，我们将推出适用于 Adyen Payouts、Management 和 Balance Platform API 的独立软件包——它们各自具有不同的身份验证方式、URL 前缀规则和使用场景。

企业版

需要为 Agent 支付设置治理机制、预算限额和审计记录？CodeSpar Enterprise 在这些 MCP 服务之上提供策略引擎、支付路由和合规模板。

身份验证

启动服务前，请设置以下环境变量：

ADYEN_API_KEY （必需，机密） — Adyen API 密钥（在 Customer Area → Developers → API credentials 中生成）
ADYEN_MERCHANT_ACCOUNT （必需） — Adyen 商户账户代码（会出现在大多数请求正文中）
ADYEN_ENV — test | live。默认为 test。
ADYEN_LIVE_URL_PREFIX — 当 ADYEN_ENV=live 时必需。您的商户专属前缀，例如 1797a841fbb37ca7-AdyenDemo

请在提供商的开发者门户申请凭据：https://docs.adyen.com。