用途：为巴基斯坦网站、移动应用和电商平台设计、实现、审查并排查安全的 Easypaisa 商户支付集成。核心原则是依据商户当前获批的集成指南，而非复制旧代码片段；文档与可用支付模式可能因商户协议和环境而异。
主要能力：先检测仓库中已有的 Easypaisa/Easypay 包、插件、网关客户端、商户/店铺 ID、hash-key 配置、环境 URL、托管结账表单、移动账户或 OTC 流程、回调路由、交易状态校验、冲正处理、订单字段、结算任务、测试与部署密钥。若已有集成，识别其指南版本、启用模式、签名规则、端点、订单生命周期与已知故障，增量修复并保留已认证行为；若无集成，则按项目现有技术栈和商户最新接入包设计。
使用方式：获取最新商户集成指南、沙箱/预发信息、获批支付模式、凭据、测试账号、签名示例、回调规则、状态/冲正 API、认证用例、结算条款与生产切换包；记录指南/API/插件版本并与现有代码比对。支付前在服务端创建唯一商户订单/参考号的内部待处理订单，服务端计算金额、币种、折扣、配送与客户归属，绝不接受客户端权威支付值。按文档字段、顺序、编码和算法生成请求与完整性值，签名密钥仅存服务端。仅通过合同约定的托管/直连/移动账户/OTC 流程引导客户，使用 HTTPS 返回与服务器通知 URL。浏览器返回仅作用户体验，须校验并去重服务端回调，再用获批状态机制或商户门户确认不确定结果。服务端验证后仅履约一次，记录交易、订单、渠道、状态与结算标识。实现失败、取消、超时、重复、延迟回调、冲正、退款（如支持）与结算不一致路径。在预发环境用获批用例测试并完成商户认证后再上线。
限制：不得编造或复制凭据名、请求字段、端点 URL、哈希顺序、算法、响应码、状态值或回调规则，须对照当前商户文档与测试向量验证。不得将在线支付网关与个人钱包转账、商户 QR/Till、支付链接、批量代付、银行卡收单、托管或订阅引擎混淆。不得在浏览器代码、移动应用、仓库、日志、截图或错误中暴露商户凭据或签名密钥；不得仅凭查询参数、成功页、客户端 JSON、短信、截图或重定向标记订单已支付；须使用精确官方规范化校验消息完整性，比较摘要时须用时间安全比较；须强制唯一订单与外部交易标识并使履约幂等；超时或响应丢失视为未知而非失败，直至验证；使用整数最小单位或指南要求的精确小数格式，禁用二进制浮点；不得盲目重试创建扣款/支付；未经明确批准不得执行实时支付、冲正、退款或更改凭据。
参考路由：references/integration-workflow.md 涵盖订单状态、托管/移动账户/OTC 流程、回调、验证、插件与测试；references/security-and-operations.md 涵盖签名、密钥、幂等、对账、监控与生产上线；references/research-notes.md 提供带日期的官方来源、当前公开声明、社区证据及需重新核实的细节。
验证与输出：运行相关格式化、静态分析/类型检查、测试与构建；报告是否发现或从零添加 Easypaisa、所用产品/模式与指南版本、已实现流程、回调验证、幂等、交易状态恢复、对账、认证状态及剩余商户门户配置；明确区分公开研究、商户提供的规范、预发证据与实时批准。