跳过安装。2 分钟内即可运行。
在 cloud.anythingmcp.com 开始免费试用,一键添加 noon payments,然后将你的 AI 客户端(Claude、ChatGPT、Copilot 或 Cursor)指向生成的 MCP 端点。无需 Docker,无需 git clone,无需任何工程经验。
摘要
noon payments 支付网关(阿联酋、沙特阿拉伯、埃及):按订单 ID 或商户参考号查询订单状态,包括已授权、已扣款和已退款总额及交易,定期生成的结算和佣金报表,订阅以及卡令牌。扣款和退款已包含在内,但安装时为关闭状态。
试试这样问
noon payments 的示例提示
点击任意提示即可复制,然后粘贴到 Claude、ChatGPT、Cursor、Gemini、Copilot 或 OpenClaw 中,在该连接器上运行。
Claude 是 AI,可能会出错。请核对回答。
💡 无需安装? 直接使用 cloud.anythingmcp.com。 登录、点击 Connectors → noon payments、粘贴凭证、生成 MCP API key,即可完成。无 Docker、无
git clone、无本地服务器。
noon payments
noon payments 支付网关(阿联酋、沙特阿拉伯、埃及):按订单 ID 或商户参考号查询订单状态,包括已授权、已扣款和已退款总额及交易,定期生成的结算和佣金报表,订阅以及卡令牌。扣款和退款已包含在内,但安装时为关闭状态。
设置
设置大约需要 5 分钟。你需要能访问 noon payments 的 Merchant Portal。
- 在 Merchant Portal 中打开 Account Settings > Applications。新建一个应用或使用已有应用,只授予它需要的角色:查询订单用 Payment Integrator 或 Refund Manager,报表用 Financial Auditor,卡令牌用 Token Manager。
- 拼出密钥
BusinessIdentifier.ApplicationIdentifier:ApplicationKey:开通邮件中的 business identifier、一个点、application identifier、一个冒号和 application key。将其进行 Base64 编码,例如用printf '%s' 'mybusiness.myapp:KEY' | base64,然后只把 Base64 文本粘贴到NOON_PAYMENTS_AUTH_KEY,不要带 Key 这个词。连接器会发送Authorization: Key <该文本>。 - 把
NOON_PAYMENTS_API_URL设为https://api.noonpayments.com(全球,正式)或https://api-test.noonpayments.com(测试)。地区端点为https://api.sa.noonpayments.com和https://api.eg.noonpayments.com,测试版本为https://api-test.sa.noonpayments.com和https://api-test.eg.noonpayments.com。只填端点,不带/payment/v1。每个环境的密钥不同。 - 安装连接器,用
noon_payments_get_order_by_reference和商店订单号查询一笔最近的订单,以检查密钥。
订单 ID 和订单参考号:order_id 是发起付款时 noon 返回的数字订单 ID,与商店订单一起保存(通常作为付款交易 ID)。order_reference 是当时发送的你自己的参考号,通常是商店订单号。如果多笔订单共用一个参考号(重试),会返回最新的一笔;用订单 ID 可精确匹配。
可读取的内容:按 ID 或你的参考号查询的订单,包括状态(INITIATED、AUTHORIZED、CAPTURED、PARTIALLY_CAPTURED、REFUNDED、REVERSED、CANCELLED、FAILED、MARKED_FOR_REVIEW 等)、金额和币种、已授权、已扣款、已退款、已撤销和剩余总额、交易(AUTHORIZATION、CAPTURE、REFUND 等,每笔都有状态、金额、时间和 ID)、脱敏后的支付信息和后续操作;noon 按天或按月生成的定期报表,每份都附有下载 ZIP(Excel 或制表符分隔)的限时链接;定期订阅的创建日期、状态、有效期、金额和计划;以及已保存卡令牌背后的脱敏卡信息(卡组织、脱敏卡号、有效期、持卡人、状态)。
如何解读订单:resultCode 为 0 只表示请求成功,并不表示付款成功。AI 会根据订单状态和 nextActions 判断。
对账:ReconciliationSettlement 是每日报表,列出需要与银行结算核对的扣款和退款;ActiveSubscriptions、PaymentTokens、MerchantCommissions 和 MerchantCommissionDetails 为月度报表。对于某一天的结算,AI 会用 report_type ReconciliationSettlement 和该日期列出定期报表,你在链接过期前从 ReportUrl 下载文件。对账时它不会逐笔查询订单,因为 noon 会限制重复查询。
安装时关闭:noon_payments_capture_order(对 AUTHORIZED 订单全额或部分扣款,使资金进入商户账户)和 noon_payments_refund_order(使用订单中 CAPTURE 交易的 ID,把扣款退回客户的卡;无法撤销,需要 Refund Manager 角色)。两者都会动用资金,因此由管理员有意开启。即使开启后,AI 也会先向你展示订单、金额和币种并等待你确认,并传入 transaction_reference,避免重试时重复执行。
限制:没有列出或搜索订单的接口,因此 AI 按 ID 或参考号查询订单,或使用每日报表。卡令牌查询不适合批量运行。
常见错误:失败会以 HTTP 4xx 或 5xx 返回,并带有 resultCode、message 和 classDescription。Rejected_Unauthenticated 表示密钥或环境错误;Rejected_AccessDenied(或 403)表示应用缺少该调用所需的角色;Invalid_BadRequest 指向某个参数。404 通常表示 NOON_PAYMENTS_API_URL 中带了路径,或该环境中不存在这笔订单。429 表示被限流:AI 会等待后再重试,且不会重复同一个失败的请求,因为 noon 可能会锁定订单或封禁地址。
该连接器不会发起付款,不会授权、撤销或取消订单,也不处理欺诈审核。
前提条件: NOON_PAYMENTS_API_URL, NOON_PAYMENTS_AUTH_KEY
本地安装连接器
curl -fsSL https://raw.githubusercontent.com/HelpCode-ai/anythingmcp/main/docker-compose.quickstart.yml -o docker-compose.yml
printf 'JWT_SECRET=%s\nENCRYPTION_KEY=%s\n' "$(openssl rand -hex 32)" "$(openssl rand -hex 32)" > .env
docker compose up -d
打开 http://localhost:3000/connectors/store,选择 noon payments 并填入前提条件中列出的环境变量。
可用工具
| Tool | What it does |
|---|---|
noon_payments_get_order | Get a noon payments order by its order id: order status (INITIATED, AUTHORIZED, CAPTURED, PARTIALLY_CAPTURED, REFUNDED, REVERSED… |
noon_payments_get_order_by_reference | Get a noon payments order by your own order reference (order.reference sent at INITIATE, e.g. the shop order number) with the same details… |
noon_payments_list_scheduled_reports | List the scheduled reports noon generated for a day or month, each with ReportName, ReportType and a time-limited ReportUrl to download the… |
noon_payments_get_subscription | Get a recurring subscription by its identifier: creation date, status, validity, amount and schedule |
noon_payments_get_card_token | Get the masked card behind a saved card token (brand, masked number, expiry, holder name, status) |
noon_payments_capture_order | Capture an AUTHORIZED order in full or in part so the funds move to the merchant account |
noon_payments_refund_order | Refund a captured order in full or in part back to the customer card |
示例提示
- “我们商店订单 100245 对应的 noon payments 订单是什么状态?已扣款和已退款分别是多少?”
- “订单 3108459210 是否已全额扣款,还是仍有剩余金额?”
- “从 noon payments 获取昨天的 ReconciliationSettlement 报表,并给我下载链接。”
- “查询这个订阅,告诉我它的状态、金额和计划。”
- “从订单 3108459210 的扣款中退款 75 AED。先给我看订单和金额。”
下一步
这份指南对你有帮助吗?