用途:该技能用于与 Fattmerchant(订阅制定价的支付处理平台)交互,管理数据、记录并自动化工作流。适用对象为需要接入 Fattmerchant 数据进行操作的用户。
主要能力:资料列出的可操作对象包括 Customer、Payment Method、Invoice、Transaction、Merchant、User、Role、Plan、Subscription、Terminal、Product、Category、Discount、Tax、Gift Card、Report、Batch、Deposit。可通过 Membrane 预置 action 完成查找与执行,也可用代理直接请求 Fattmerchant API(官方文档 https://fattmerchant.readme.io/)。
使用方式:先安装 CLI:npm install -g @membranehq/cli@latest;登录:membrane login --tenant --clientName=<agentType>,无头环境会打印授权 URL,完成后执行 membrane login complete <code>。建立连接:membrane connection ensure "https://fattmerchant.com/" --json;若状态为 BUILDING,用 npx @membranehq/cli connection get <id> --wait --json 轮询至 READY;若返回 CLIENT_ACTION_REQUIRED,按 clientAction 提示由用户完成认证后再次轮询。查找动作:membrane action list --connectionId=CONNECTION_ID --intent "QUERY" --limit 10 --json。执行动作:membrane action run <actionId> --connectionId=CONNECTION_ID --input '{"key": "value"}' --json,结果在 output 字段。代理请求:membrane request CONNECTION_ID /path/to/endpoint,支持 -X/--method、-H/--header、-d/--data、--json、--query、--pathParam 等参数。任意命令加 --json 可得机器可读输出。
最佳实践与限制:优先使用 Membrane 预置动作以获得内置认证、分页与错误处理,先发现再自建;不要让用户提供 API 密钥或令牌,凭据由 Membrane 服务端管理并自动刷新。资料未提供具体动作清单、收费标准、配额及平台兼容性细节。