用途：为巴基斯坦网站、应用和电商平台设计、实现、审查、迁移及排查 JazzCash 商户支付集成。
主要能力：先检查仓库中是否已有 JazzCash 相关包、插件、SDK、支付表单、pp_ 字段、商户 ID、密码、integrity salt、secure-hash 构建器、沙箱/生产 URL、回调路由、状态与退款逻辑、交易表、对账任务、测试和部署密钥；若已存在，识别集成模式、API/文档版本、环境、已启用支付方式、哈希规则、订单生命周期与故障，并给出最安全的升级路径；若不存在，则按项目现有技术栈和该商户最新文档设计集成。
使用方式：获取最新商户指南、集成模式、已启用方式、沙箱凭据、回调规则、哈希示例、状态/退款操作、响应码表、认证用例、结算条款和生产包；记录确切文档、插件或 API 版本；服务端创建带唯一商户交易/参考号的待处理订单；服务端计算金额、币种、折扣、配送、有效期与客户归属；严格按文档构建并哈希最终请求；通过获批的托管、重定向、钱包、凭证或卡流程引导客户；将浏览器返回仅视为展示，认证并去重服务端通知，校验订单与金额，通过获批状态源核实不确定结果；权威成功后仅履约一次，持久化网关交易、响应、支付方式、冲正/退款与结算标识；处理取消、拒绝、过期、超时、响应丢失、重复/延迟回调、冲正/退款与结算不一致；通过沙箱和商户认证测试后再申请生产激活。
限制与规则：不得猜测或复制端点 URL、凭据名称、签名字段、字段顺序、编码、算法、响应码或状态含义，须对照商户门户、当前指南和测试向量确认；不得混淆在线支付网关与个人钱包转账、商业 QR/Raast QR、支付链接、批量付款、零售代理服务或其他 JazzCash 企业 API；不得在前端代码、移动二进制、仓库、日志、URL、截图或错误中暴露凭据或完整性材料；不得仅凭重定向、查询参数、客户端响应、短信或截图标记订单已支付；须实现规范化与安全哈希校验，适用时使用定时安全摘要比较；内部订单参考号与 JazzCash 交易标识须唯一，支付状态转换与履约须幂等；超时在状态核实或对账证明前视为未知，不得盲目发起二次扣款；金额使用整数最小单位或指南规定格式，不得使用二进制浮点；未经明确批准不得执行实时支付、捕获、退款、冲正或更改凭据。
参考文件：references/integration-workflow.md 涵盖模式、订单状态、请求处理、回调、状态恢复、插件与测试；references/security-and-operations.md 涵盖哈希、密钥、幂等、监控、对账与上线控制；references/research-notes.md 提供带日期的来源与需复核细节。
验证与报告：运行项目格式化、静态/类型检查、测试与构建；报告 JazzCash 是已存在还是从零添加、指南/API/插件版本、已启用方式、已实现流程、回调与哈希验证、幂等性、未知状态恢复、对账、认证状态及剩余商户门户配置；区分公开研究、商户规格、沙箱证据与生产批准。