📦 创建支付凭证

创建支付凭证 使用 Link 从 Link 钱包获取安全的一次性支付凭证以完成购买。

选择如何调用 Link Link CLI 可作为 MCP server 或独立 CLI 运行。优先使用 MCP server——它避免 shell 解析问题，是官方集成路径。 先检查 MCP server：在活跃 MCP 连接中寻找 link-cli MCP server。若存在，直接调用其工具（如 auth_status、auth_login、spend-request_create、payment-methods_list、mpp_pay、mpp_decode）。 仅当 MCP server 不可用时才回退到 CLI。 安装：npm install -g @stripe/link-cli，然后使用下方 shell 命令。 本文档其余部分展示 CLI 命令；使用 MCP server 时，将每条命令映射到对应 MCP tool，参数与行为完全一致。

CLI 命令 ↔ MCP tool auth login → mcp__link-cli__auth_login auth logout → mcp__link-cli__auth_logout auth status → mcp__link-cli__auth_status spend-request create → mcp__link-cli__spend-request_create spend-request update → mcp__link-cli__spend-request_update spend-request retrieve → mcp__link-cli__spend-request_retrieve spend-request request-approval → mcp__link-cli__spend-request_request-approval payment-methods list → mcp__link-cli__payment-methods_list payment-methods add → mcp__link-cli__payment-methods_add mpp pay → mcp__link-cli__mpp_pay mpp decode → mcp__link-cli__mpp_decode

运行命令（CLI 回退） 所有命令支持 --format json 输出机器可读结果。通过 flag 传参（运行 link-cli --help 查看完整字段、类型与约束）。 重要： auth login 需带 run_in_background=true（或 TaskOutput(task_id, block: false)）。它先向 stdout 输出 JSON，然后保持运行并轮询用户操作。 agent 侧 JSON 约定： auth login --format json：首对象含 verification_url 与 phrase；最终对象在审批成功后含认证结果。 spend-request create --request-approval --format json：立即返回创建的支出请求，并带 _next.command 轮询提示。 spend-request request-approval --format json：立即返回审批链接，并带 _next.command 轮询提示。 spend-request retrieve --interval --format json：轮询直至支出请求到达终态，然后返回终态请求。若 --timeout 或 --max-attempts 用尽仍非终态，以非零码 "POLLING_TIMEOUT" 退出。 auth login 需持续读取 stdout 直至进程退出；支出审批需立即向用户展示 approval_url 并启动 _next.command 轮询。用户必须访问验证/审批 URL，务必完整展示该 URL。

核心流程 复制清单并跟踪进度： 步骤 1：用 Link 认证 步骤 2：评估商户站点（确定凭证类型） 步骤 3：获取支付方式 步骤 4：用正确凭证类型创建支出请求 步骤 5：完成支付

步骤 1：用 Link 认证 检查状态：link-cli auth status --format json 若响应含 update 字段，先执行其中的 update_command 升级。 若未认证：link-cli auth login --client-name "" --format json 将 替换为代理或应用名称（如“个人助手”“购物机器人”），该名称将显示在用户 Link 应用中。 向用户展示 url 与 phrase，并提示：“请访问以下 URL 以批准对 Link 的安全访问。” 用户完成认证前勿继续；每次登录前都先检查当前认证状态。

步骤 2：评估商户站点 创建支出请求前必须完成：

• 明确商户接受的支付方式（卡、机器支付或其他），勿默认使用卡凭证类型。
• 确认最终总金额（含运费、税费等）。
• 清楚用户购买的商品详情（尺码、颜色、配送选项等）。
• 浏览商户页面，阅读相关内容以确定支付方式。