用途:帮助在现有代码库中设计、实现、审查和排查巴基斯坦 1LINK 1BILL 账单集成,覆盖账单查询、账单支付、固定发票或凭证收款、可变或充值缴费等流程。
主要能力:先检查仓库,识别是否已有 1LINK 或 1BILL SDK、客户端、URL、凭据、biller 前缀、PSID 或消费者号生成、查询/支付/撤销/状态处理器、数据库记录、消息签名、结算文件、对账任务、测试和认证产物;若已有集成,确认具体 1LINK 产品、API/目录版本、组织角色、环境、端点、认证/签名方案和已实现流程,并以最小改动修复;若没有,则按项目语言、框架、数据模型、安全、日志、任务和测试约定设计。
使用方式:先获取最新 1LINK 开发者门户产品选择、私有 API 规范/OpenAPI 文件、入驻包、凭据、速率限制、测试数据、认证用例和生产切换说明;记录确切目录/API 版本并与现有实现比较。定义账单类别、biller 前缀/参考规则、金额规则、过期、重复支付策略、付款人可见字段和内部发票生命周期。将查询、支付、合同允许的撤销/冲正、支付状态查询、对账和异常处理建模为独立幂等操作。服务端对账单参考、金额、过期、已付状态和结算保持权威,不信任客户端截图或客户端报告结果。存储关联标识以追踪应用记录、1LINK 请求、渠道交易、状态查询、结算和支持案例。按当前认证包保护凭据和消息完整性,安全拒绝无效、重放、未授权或格式错误的请求。测试重复、延迟、缺失、冲正、超时和模糊交易,而不仅是成功支付。完成 1LINK 沙箱测试和正式认证后再上生产,切换时只改已批准的环境配置。
可靠性规则:超时和传输失败视为未知结果,直到状态查询或对账证明结果,绝不盲目重试支付;账单查询只读,支付入账在合同唯一交易标识下幂等;对外部交易 ID 和内部账单/支付参考实施唯一约束;使用事务性状态变更和仅追加审计轨迹;不因用户返回页面、截图、短信或前端请求就标记账单已付;将交易记录与 1LINK/结算报告对账并向运营人员暴露不一致;保留渠道、参考、金额、日期时间、追踪/交易标识等可读支持数据,但不记录密钥或完整敏感载荷。
参考路由:references/product-and-api-surface.md 用于选择正确 1LINK 产品并了解公开确认的 1BILL 操作;references/implementation-workflow.md 用于状态建模、查询/支付/状态/撤销流程、PSID/参考用户体验和认证;references/security-and-reliability.md 用于认证、财务状态、重试、日志、对账或生产上线前;references/research-notes.md 用于带日期的官方来源、公开文档限制、近期社区报告和必须重新验证的内容。
验证与输出:运行相关格式化、lint、类型检查和测试;报告 1BILL 是发现还是从零添加、所选角色和产品、检查的版本和私有规范、已实现操作、幂等策略、对账计划、认证状态以及剩余 1LINK 或合作伙伴配置;明确标注假设,绝不将沙箱成功描述为生产批准。
限制:不得虚构请求字段、响应码、签名、加密、URL、凭据、前缀规则、PSID 长度或超时行为,必须从商户当前 1LINK 沙箱/认证文档获取。1BILL 是统一账单支付通道,不应呈现为嵌入式卡表单、订阅引擎、钱包推送 API 或 Stripe 替代品;若需求是 QR、别名、IBAN 或 Request to Pay 商户受理,应评估 1GO/Raast P2M;若是卡结账,应评估已批准支付网关。