newebpay-query

newebpay-query 技能为 AI 开发助理提供了一个标准化的工作流程，用于将蓝新金流的交易查询功能集成至现有的支付模块中。此工具专为开发电商平台、支付网关或商家后台的工程师设计，协助其解决订单状态同步、交易验证及自动化对账的难题。通过自动化处理 QueryTradeInfo API 的实现，能确保支付数据的准确性与系统稳定性。

• 提供明确的实现架构，包含如何利用 HashKey 与 HashIV 产生符合规格的 SHA256 CheckValue 校验码。

• 内建标准化的请求构建逻辑，包含参数封装、时间戳 (TimeStamp) 管理以及 JSON 响应处理。

• 支持多种集成场景，包括 API 实时状态检查、前端订单历史查询，以及后台排程自动化对账。

• 简化常见 API 错误的排除流程，涵盖交易查无此笔 (TRA10001)、校验码错误 (TRA10002) 与时间戳误差 (TRA10003) 的处理建议。

• 使用者需确保环境变量中正确设置了 NEWEBPAY_MERCHANT_ID、NEWEBPAY_HASH_KEY 与 NEWEBPAY_HASH_IV。

• 此工具适用于测试与正式环境，包含自动切换机制，可弹性连接测试站点 (ccore.newebpay.com) 或正式站点 (core.newebpay.com)。

• 核心输入包含商店订单编号 (MerchantOrderNo) 与订单金额 (Amt)，两者均为产生强制性 CheckValue 的关键参数。

• 输出信息包含交易状态 (TradeStatus)，例如 0 为未付款、1 为已付款、2 为失败、3 为已取消、6 为退款，可直接用于更新后端订单数据库。