本技能用于 Finexus 在线支付(PayMaster)及 Kayaaku POS 终端集成,提供 API 参考、账号设置、终端集成与官方文档映射等参考资料。
主要用途:
- 构建与哈希服务端支付消息(0280、0880、0180 等)。
- 处理浏览器返回(0290)并验证 t002_SHV,通过 0780 查询确认交易状态。
- 实现冲正/退款(0400)、DuitNow Pay、动态 QR、静态 QR、卡令牌/循环、预授权等场景。
- 调试集成问题,审查安全漏洞,解释官方文档。
核心能力:
- 提供端点目录、字段表、MTI、安全哈希方法(含测试向量)、金额规则、查询/冲正/退款、DuitNow Pay、QR、循环、预授权、状态码及插件注意事项。
- 账号注册、凭据、沙箱与生产环境、环境变量名称、方法激活、定价链接和结算信息。
- Kayaaku POS 终端集成(App-to-App、蓝牙、USB、HTTP JWE、预授权 HTTPS、UCAT)。
- 官方文档页面映射与覆盖范围。
使用方式:
- 阅读 references/finexus-api.md 获取 API 指导与集成代码。
- 阅读 references/account-setup.md 了解账号设置。
- 阅读 references/finexus-kayaaku-pos.md 了解终端集成。
- 阅读 references/source-map.md 选择官方页面。
- 按核心工作流:识别环境与主机、识别支付面、选择 MPI 库或原始 API、创建本地待支付记录(唯一 f263_MRN)、构建并哈希 0280 消息、重定向至 /upp/faces/upp/payment.xhtml、验证 0290 返回、通过 0780 查询确认(f274_QRespCode=00)、幂等结算。
适用场景:
- 开发、调试、审查 Finexus 支付集成。
- 需要确保支付安全、幂等性和正确性验证的项目。
- 涉及在线支付、QR 支付、POS 终端等多种支付方式。
限制:
- 必须阅读参考资料后再提供 API 指导或编写代码。
- 不得猜测生产主机、测试卡、费用或结算时间,需向 Finexus 确认。
- 生产环境有请求频率限制,需遵守查询规则。
- 部分细节(如生产主机、可选字段哈希顺序、启用的支付方式、结算时间、测试卡、Kayaaku POS 签名差异)需与 Finexus 确认。