用途
本技能面向 iPay88 马来西亚支付网关(OPSG,Online Payment Switching Gateway)的集成工作,可用于配置、构建、调试、审查和讲解相关集成。资料来源为 iPay88 自身的 OPSG 技术规范 v1.6.4.4(2024年9月11日,经社区镜像获得),加上 payment.ipay88.com.my 的官方页面(签名测试器、webservice WSDL)以及 iPay88 存档的支持 FAQ;镜像与官方页面不一致时以官方页面为准,商户应向 iPay88 Support 索取现行规范并据此确认。
主要能力与核心流程
技能给出完整的集成流程:确认商户已获得 Merchant Code 与 Merchant Key、已登记 Request URL、已为 ResponseURL 和 BackendURL 白名单服务器 IP;在本地创建含唯一 RefNo(最多 30 字符)、预期金额与 MYR 币种的待处理订单;在服务端用 Merchant Key 生成 HMAC-SHA512 请求签名;渲染自动提交、POST 到 https://payment.ipay88.com.my/epayment/entry.asp 的 HTML 表单,所有请求字段都必须存在(可选字段可为空);在 ResponseURL(浏览器 POST)校验签名、金额、币种与 RefNo 后展示结果页;在 BackendURL(服务端 POST,仅成功时)以同样方式校验、幂等结算,并且只输出 RECEIVEOK、不带 HTML;在履约前或未收到 POST 时重查询 enquiry.asp(回复 00 表示已支付)或 SOAP webservice(Version 4,Status 1 表示已支付);无论 ResponseURL、BackendURL 还是重查询先到达,只结算一次。
关键事实
支付页为 HTML 表单 POST,而非 JSON API;重查询 enquiry.asp 使用 MerchantCode、RefNo、Amount 参数并返回纯文本;Webservice 重查询地址为 .../TxDetailsInquiry.asmx,操作 TxDetailsInquiryCardInfo,Version = 4。资料明确没有记录独立的沙箱主机,测试在生产主机上用真实商户账户、从已登记的 Request URL、以 MYR 1.00 进行。签名类型为 HMACSHA512,规范 v1.6.4.4 已由 SHA256 改为 HMAC-SHA512,SHA256 集成已弃用。请求签名按 MerchantKey + MerchantCode + RefNo + Amount + Currency 计算,Amount 去除 "." 与 ",",小写十六进制、128 字符;规范还会在请求串后追加 Xfield1,Xfield1 为空时两种形式一致(该规则存在未决问题)。响应签名按 MerchantKey + MerchantCode + PaymentId + RefNo + Amount + Currency + Status 计算。响应 Status 中 1 为成功、0 为失败;Webservice 重查询另有 6 待处理、20 已授权;未知 RefNo 返回空 Status 与 Errdesc Record not found。BackendURL 只接收成功通知,iPay88 同时向 ResponseURL 与 BackendURL 发送,未收到 RECEIVEOK 时最多重试后端 3 次。PaymentId 可选,留空则由客户在 iPay88 页面选择,其数值见 iPay88 Support 另行提供的 Appendix I.pdf(MYR)与 Appendix II.pdf(多币种)。退款、循环扣款与令牌化作为产品出售但无公开 API。支持邮箱为 support@ipay88.com.my,商户报告页为 https://payment.ipay88.com.my/ePayment/report。
关键规则
Merchant Key 只保留在服务端,不得放入浏览器代码;签名必须基于实际提交的 Amount 字符串计算;用常量时间比较校验响应签名,并比对金额、币种、RefNo 与 MerchantCode;不得仅凭 ResponseURL 履约;后端页面不得依赖会话或登录状态,成功后只输出 RECEIVEOK;结算在三个入口间保持幂等;不得复用已支付的 RefNo;失败无后端 POST,需通过 ResponseURL 与重查询处理;Appdeeplink 场景应用 webservice 重查询与 BackendURL;HTTP_REFERER 只能作额外检查而非凭证。
完成标准与审查
完成标准包括:请求表单提交全部字段、SignatureType=HMACSHA512 且签名与官方测试器一致;两个回调 URL 均校验签名、金额、币种与 RefNo;后端成功后仅输出 RECEIVEOK 且无会话代码;结算幂等;履约前或作为兜底执行重查询;测试覆盖错误签名、错误金额、重复 POST、Status=0、重查询的 Record not found / Incorrect amount,以及一次 MYR 1.00 的真实支付测试;部署文档列出 IPAY88_MERCHANT_CODE、IPAY88_MERCHANT_KEY、ResponseURL、BackendURL 及白名单 IP。被问及是否"100% 确信"时,技能要求运行漏洞审查循环:列出信任边界,检查伪造回调、重放、金额篡改、签名金额格式不一致、Xfield1 不匹配、残留 SHA256、重复 RefNo、两路 POST 竞争、缺少 RECEIVEOK 导致重试、依赖会话的后端页、失败支付无后端通知、电子钱包 deeplink 无响应数据、将待处理(6)误判为已支付等绕过场景,并补充修复措施后说明剩余不确定性。
适用场景与限制
适用于使用 OPSG 的马来西亚商户支付集成开发、代码审查与问题排查。限制在于:规范来自镜像,Xfield1 规则、PaymentId 取值、退款与循环扣款产品等仅能由 iPay88 Support 确认;未提供独立沙箱;退款等无公开 API;具体支付方式需在账户侧开通,资料未展开。