Mercury API 用于企业银行与金融科技操作,当用户提及 Mercury、business banking、bank account 或 fintech operations 时可使用。所有请求通过 HTTPS 调用,并携带 Authorization: Bearer $MERCURY_TOKEN 请求头。
主要能力按接口分组:账户方面可列出所有账户、按 ID 获取账户、获取账户卡片;交易方面可列出账户交易、按日期范围/状态/数量过滤、按 ID 获取单笔交易;转账方面可创建账户间内部转账、发起 send money 请求并查询请求状态;收款人方面可列出、按 ID 获取、创建收款人;还可列出对账单并下载 PDF、获取组织信息、列出与获取 Treasury 账户及其交易、列出用户、列出信用账户、以及应收账款下的客户与发票(列出客户、创建客户、列出与创建发票、下载发票 PDF)。
排障可运行:zero doctor check-connector --env-name MERCURY_TOKEN,或 zero doctor check-connector --url https://api.mercury.com/api/v1/accounts --method GET。示例调用格式为 curl -s "https://api.mercury.com/api/v1/accounts" --header "Authorization: Bearer $MERCURY_TOKEN";POST 请求先写入 JSON 文件再以 -d @/tmp/mercury_request.json 提交。
使用限制与注意事项:Mercury 可能实施速率限制,高并发时需实现退避;转账操作应使用 idempotencyKey 防止重复交易;切勿在日志或客户端代码中暴露 API token;金额通常以美元小数表示;大结果集在支持处使用 limit 与 offset 分页。API 参考文档见 https://docs.mercury.com/reference/getaccount,控制台为 https://dashboard.mercury.com。其他未在资料中说明的收费、价格与平台细节暂未提供。