SuperAPI AI 工具集

setup-revenue-monster

编程与开发

查看项目

更新于 11-17 04:10

技能介绍

Revenue Monster 支付网关集成技能,适用于基于 Revenue Monster(RM)Open API 的支付集成开发工作。

资料组织 在给出事实性 API 指导或编写集成代码前,应先阅读 references/revenue-monster-api.md,其中包含环境、OAuth 令牌流程、RSA 签名算法(含精确待签名字符串)、托管收银台字段、重定向与通知载荷、查询、退款、冲正、对账、支付方式、状态与错误码,以及完整接口目录。 详细内容分散在以下文件:references/revenue-monster-objects.md(交易对象、嵌套对象、类型/状态枚举、方式与地区矩阵、FPX B2C/B2B 银行代码);references/revenue-monster-tokenization.md(循环扣款、令牌化客户、绑定卡扣款、卡存档令牌);references/revenue-monster-instore.md(Quick Pay、终端事件、POS、Android deeplink);references/revenue-monster-invoice.md(发票/支付链接 API,/api/v3/...);references/revenue-monster-errors.md(全部有文档的错误码)。注册、Client ID/Client Secret/Store ID/RSA 密钥位置、沙箱激活、支付方式激活、环境变量名、定价或插件相关问题,参阅 references/account-setup.md;选择官方文档页或 SDK 文件时参阅 references/source-map.md。

核心工作流

  1. 确定环境:沙箱(sb-oauth、sb-open)或生产(oauth、open)。
  2. 确定集成面:托管 Web Payment 收银台、Mobile Payment、Direct Payment Checkout(自建 UI、QR、FPX 银行、原生卡)、Quick Pay(POS 扫码)、令牌化/循环扣款、低代码按钮或插件。
  3. 确认商户门户配置:应用 Client ID 与 Client Secret、已上传的 RSA 公钥、已保存的 RM 服务器公钥、Store ID、已激活的支付方式。
  4. 服务端使用 POST /v1/token(clientId:clientSecret 的 Basic 认证,grantType: client_credentials)获取访问令牌,缓存并在到期前刷新。
  5. 调用 RM 前先在本地创建待支付记录,使用唯一 order.id(最长 24 字符),金额以 sen 为单位。
  6. 调用 POST /v3/payment/online,携带 Bearer 令牌及 X-Signature、X-Nonce-Str、X-Timestamp,将客户重定向至 item.url。
  7. 将 redirectUrl(?status=&orderId=)视为仅用于浏览器体验。
  8. 收到 notify(eventType: PAYMENT_WEB_ONLINE)时记录载荷,再用已签名请求调用 GET /v3/payment/transaction/order/{orderId} 重新查询。
  9. 仅当查询到的交易为 SUCCESS 且 order.id、order.amount、currencyType、store 与环境全部匹配时,才幂等地完成履约。
  10. 为待支付订单运行重查任务,因为 notify 仅在成功时触发且可能丢失。

核心事实 OAuth 地址:https://oauth.revenuemonster.my/v1/token,沙箱为 https://sb-oauth.revenuemonster.my/v1/token。Open API:https://open.revenuemonster.my,沙箱为 https://sb-open.revenuemonster.my,支付 API 位于 /v3 下。托管收银台:POST /v3/payment/online,type 为 WEB_PAYMENT 或 MOBILE_PAYMENT,layoutVersion v4。金额为以 sen 为单位的整数(100 = RM 1.00),最低 RM 0.10,仅支持 MYR。 签名:RSA PKCS#1 v1.5 + SHA-256,待签名字符串为 data=<b64>&method=<lower>&nonceStr=<n>&requestUrl=<url>&signType=sha256&timestamp=<unix>,其中 <b64> 是按键排序、紧凑 JSON 的 Base64,且 <、>、& 转义为 \u003c、\u003e、\u0026。请求头格式:X-Signature: sha256 <base64signature>。Nonce 在 120 秒内必须唯一;时间戳为 UTC Unix 秒,需在服务器时间 120 秒内。空请求体(GET)省略 data= 项。验证 RM 回调时 requestUrl 可省略,使用 RM 服务器公钥验证。 重定向状态:SUCCESS、FAILED、CANCELLED、EXPIRED。notify 仅在支付成功时发送,失败与退款不触发。交易状态:SUCCESS、FAILED、IN_PROCESS、FULL_REFUNDED、PARTIAL_REFUNDED、REVERSED。退款:POST /v3/payment/refund,含 transactionId、refund.type FULL、refund.currencyType、refund.amount、reason。冲正(超时,约 15 分钟):POST /v3/payment/reverse,含 orderId。凭证位于商户门户 > Developer > Applications。

关键规则 Client Secret、访问/刷新令牌及 RSA 私钥仅可保存在服务端。不得仅凭 redirectUrl 查询参数或 notify 载荷标记已支付,须依据已签名的服务端查询完成履约。对实际调用的确切 requestUrl(含查询串)签名,并将 HTTP 方法转为小写。Base64 前需递归排序 JSON 键并紧凑化,否则返回 INVALID_REQUEST_SIGNATURE(沙箱会返回各步骤的调试对象)。每次请求生成新的 32 字符 nonce 与时间戳,复用 nonce 会导致重复请求错误。沙箱密钥、令牌、Store ID 与服务器公钥只能与沙箱主机搭配,严禁混用环境。order.id 每次尝试须唯一(否则 ORDER_ID_DUPLICATE),并保存 checkoutId 与 transactionId。若支付调用超时,先按 orderId 冲正再以新订单重试,避免重复扣款。notify 处理与退款须幂等,退款前检查 balanceAmount。宣称生产可用前,应在门户中核实支付方式已激活(例如 BOOST_MALAYSIA_NOT_ACTIVE)、定价与结算。

完成标准 满足以下条件才算完成集成:令牌获取、缓存与刷新在服务端以 Client ID 与 Secret 的 Basic 认证运行;每次 Open API 调用均携带 Bearer 令牌、X-Signature、X-Nonce-Str、X-Timestamp 并通过沙箱;托管收银台在服务端创建,金额以 sen 计且 order.id 唯一,客户跳转至 item.url;重定向处理仅展示状态并触发重查,不做履约;notify 处理记录载荷、按订单 ID 重查交易,仅在 SUCCESS 且金额、币种、订单 ID、门店匹配时履约;重复 notify、缺失 notify、失败/过期/取消的结账及退款均幂等且有测试;测试覆盖签名字符串构建(排序 JSON、转义、空请求体)、错误金额/订单、重复 notify 与超时冲正;部署文档列出 RM_CLIENT_ID、RM_CLIENT_SECRET、RM_PRIVATE_KEY、RM_SERVER_PUBLIC_KEY、RM_STORE_ID、环境、重定向 URL 与通知 URL。

漏洞审查循环 当被问及某 Revenue Monster 方案是否"100% 有把握"时,可运行此循环直至无事实缺口:列出信任边界(浏览器重定向、收银台页面、后端结账创建、OAuth 服务器、Open API、通知接收、签名构建、密钥存储、数据库、履约任务、退款任务、商户门户设置、支付方式激活);检查绕过路径(伪造 redirect status=SUCCESS、伪造 notify 载荷、notify 缺失、未排序或未转义 JSON 的签名、错误 requestUrl、大写方法、过期时间戳、复用 nonce、沙箱/生产密钥混用、过期访问令牌、金额错误(令吉 vs sen)、复用订单 ID、超时重复扣款、重复退款、超出服务商窗口的退款、未激活支付方式);补充修复(服务端结账、先建本地待支付、履约前签名重查、严格的金额/币种/订单/门店校验、持久化 notify 日志、幂等键、带刷新的令牌缓存、超时冲正、独立环境配置、门户能力检查);重新阅读 references/revenue-monster-api.md 中与缺口相关的章节;若结论依赖通知头名称、支付方式激活、退款窗口、定价、结算时间或商户审批,则说明剩余不确定性。

适用场景 适用于在马来西亚市场通过 Revenue Monster 接入在线支付、移动支付、自建收银台、扫码支付、令牌化/循环扣款、发票支付链接与插件集成的开发、调试、审查与文档讲解工作。

限制 本技能围绕 Revenue Monster 官方文档与 SDK 展开,具体定价、结算时间、退款窗口、支付方式激活状态与商户审批等需在商户门户核实,资料未提供确定数值。