Maybank2u Pay 支付网关集成技能
用途:该技能面向 Maybank2u Pay 网上银行支付网关的集成工作,客户通过 Maybank2u 弹窗从其 Maybank 活期或储蓄账户付款。适用任务包括搭建、构建、调试、审查与讲解相关集成。
资料与参考文件:在给出事实性指导或编写集成代码前,需先阅读 references/maybank2u-pay-api.md,其中包含端点目录、发送字符串格式、确切加密算法、环境划分、前端弹窗、实时支付通知(RPN)字段、RPN 应答约定、重定向回调参数、IP 与 SDK 源码中发现的问题。用户询问如何申请、需要哪些文件、Payee Code 来源、UAT 签核流程、Response URL 与 SSL 证书要求、报表门户、结算或卡支付网关(Maybank eBPG)时,阅读 references/account-setup.md。选择正确的官方页面或 SDK 文件以及查看覆盖说明时,阅读 references/source-map.md。
核心工作流:1)识别环境:envType 0 为 playground,1 为 UAT,2 为生产。2)确认商户在对应环境已有 Payee Code,并已在 Maybank2u Pay 门户提交支付通知技术要求(Response URL、端口、SSL 证书)。3)在构建发送字符串前,先在本地创建带唯一参考号的待支付订单。4)仅在服务端构建发送字符串并按 SDK 的方式加密,向页面返回 encryptedString 与 actionUrl。5)在支付页面由用户点击直接调用 m2upay.initPayment(encryptedString, actionUrl, 'OT'),避免弹窗被拦截。6)弹窗结果与 Callbackurl 重定向仅作为用户体验处理。7)以 RPN 为准结算:Maybank 向 Response URL 发送 HTTP POST JSON,来源为文档所列 IP,匹配 AcctId 与 Amt(以分为单位)。8)对每条 RPN 以 JSON {"Msg":{"PmtType":...,"RefId":...,"StatusCode":"0"}} 应答(或 -1、101、104)。9)按 RefId 幂等结算,重复 RPN 返回 104。10)通过 Maybank Payee Report Portal 的每日支付汇总报告与支付原始数据文件进行对账;资料称没有公开的状态查询 API。
核心事实:官方文档为 https://m2upay.maybank2u.com.my/assets/sdk/index.html(单页),另有 Java、JavaScript、PHP 的 SDK 压缩包。生产 action URL:https://www.maybank2u.com.my/mbb/m2u/m9006_enc/m2uMerchantLogin.do。三个 SDK 中的 UAT action URL:https://202.162.18.55:8443/testM2uPayment;playground:https://api.discotech.io/v1.0/testM2uPayment。请求输入包括 amount(十进制令吉,如 100.00,长度 9)、accountNumber(发票/账单参考号,字母数字,30)、payeeCode(数字,3),以及仅 SDK 使用的 refNumber 与 callbackUrl。发送字符串:Login$<payeeCode>$1$<amount>$1$<refNumber>$1$<accountNumber>$<callbackUrl>(API 参考中有空字段变体)。加密需执行两次:v = base64(AES-128-ECB-PKCS7(key, "Maybank2u simple encryption" + v)),密钥字节为 00 01 02 ... 0f,然后进行 URL 编码。资料指出密钥与盐在每个 SDK 中都是公开的,因此这只是混淆而非完整性保护。前端向名为 M2UPayment 的弹窗提交表单到 actionUrl,字段为 q(加密字符串)与 i(子服务,文档与示例中为 OT)。RPN 为 JSON Msg,含 PmtType(CashPayment 或 CCardPayment)、RefId、TrnDateTime(YYYYMMDDhhmmss)、AcctId、Amt(分)、StatusCode(00 成功,01 失败)、StatusDesc。RPN 仅用于 UAT 与生产,playground 不发送。RPN 来源 IP:UAT 202.162.18.247,生产 202.162.17.179。RPN 应答码:-1 内部错误(重发)、0 成功、101 商户拒绝、104 重复;998 与 999 为银行保留。资料称 RPN 不携带签名、哈希或 HMAC 字段(核查日期 2026-10-21)。Response URL 变更需 5 个工作日生效。资料称未记录退款、重新查询、定期扣款或令牌化 API(核查日期 2026-10-21)。
关键规则:发送字符串的构建与加密只在服务端进行,绝不能让浏览器决定 amount、payeeCode 或 accountNumber。不能信任加密字符串的完整性,因为任何人都能用公开密钥解密并重新加密。不得依据弹窗、Callbackurl 重定向或前端 JavaScript 标记已支付。仅通过 HTTPS 在已注册的 Response URL 接收 RPN,且仅接受该环境文档所列 Maybank IP 来源。结算前须将 AcctId 匹配到本地待支付订单并将 Amt(分)与预期金额匹配,资料称 Maybank 自身 Java 指南将此列为强制要求。RefId 在数据库中须唯一;重复时回复 104,绝不重复履约。仅当希望 Maybank 重发时才返回 -1(例如数据库宕机)。accountNumber 中避免使用 $,因为 $ 是发送字符串分隔符(资料注明这是从格式推断,Maybank 未明示)。上线时须同时将 UAT Payee Code 换成生产 Payee Code 并切换 envType 2。PHP SDK 使用 mcrypt,该扩展在 PHP 7.2 中已移除;需移植到 openssl_encrypt 并保证输出一致,且在 UAT 中确认。
完成标准:仅当以下条件满足时,Maybank2u Pay 集成才算完成:发送字符串与加密在服务端运行且与官方 SDK 输出逐字节一致;弹窗由用户直接点击打开并向对应环境的正确 actionUrl 提交 q 与 i;Response URL、端口与 SSL 证书已在门户为 UAT 与生产注册;RPN 处理程序检查来源 IP、解析 JSON Msg、匹配 AcctId 与 Amt、检查 StatusCode 为 00,并按文档回复 JSON;重复 RPN 返回 104,失败返回 101,瞬时错误返回 -1;测试覆盖错误 IP、未知 AcctId、错误金额、01 状态、重复 RefId 与成功场景;UAT 截图(弹窗与收到 RPN)已上传且 UAT 已在门户确认;部署文档列出 M2UPAY_PAYEE_CODE、M2UPAY_ENV_TYPE、Response URL 及各环境允许的 RPN IP。
漏洞审查循环:当被问及某 Maybank2u Pay 策略是否“100% 有把握”时,循环执行以下步骤直到没有事实缺口:列出信任边界(结账页、加密端点、弹窗、Maybank2u 登录/TAC、Callbackurl 重定向、RPN 接收端、防火墙、数据库、履约任务、收款人报表门户);检查绕过方式(用公开密钥重新加密被篡改的金额、伪造重定向、来自非 Maybank IP 的伪造 RPN、未知或已支付 AcctId 的 RPN、令吉与分混用、重复 RPN、返回 0 时 RPN 丢失、生产环境误用 UAT Payee Code、弹窗被拦截、PHP mcrypt 缺失、Java Base64 换行不一致);补充修复措施(仅服务端生成发送字符串、严格 IP 白名单、金额与参考号匹配、唯一 RefId、持久化事件日志、正确应答码、每日报表对账、按环境配置);针对任何缺口重读 references/maybank2u-pay-api.md 相关章节;说明仍存在的不确定性:无 RPN 签名、无文档化重新查询或退款 API、i 值除 OT 之外的情况、refNumber 与 callbackUrl 的用法、当前 UAT URL 与当前 IP 均须与 Maybank(maybank2upay@maybank.com)确认。
限制:资料明确指出的缺失或不确定项包括:RPN 无签名;无文档化的重新查询、退款、定期扣款或令牌化 API;i 的其他取值、refNumber 与 callbackUrl 的具体用法、当前 UAT URL 与当前 IP 需与 Maybank 确认。