SuperAPI AI 工具集

setup-gomobi

编程与开发

查看项目

更新于 11-17 02:09

技能介绍

用途

该技能面向 GoMobi 支付网关的集成工作。GoMobi 现品牌为 Mobi(Mobi Asia Sdn Bhd,前身为 Mobiversa),开发者文档仍位于 https://gomobi.io/documents。可用于搭建、构建、调试、审查和讲解 GoMobi/Mobi 支付集成。

主要能力

资料以参考文档为核心入口:

  • references/gomobi-api.md:入口文档,包含环境、凭证、完整端点目录、托管收银台签名、AES-CBC 与 3DES 算法、FPX、状态查询、IPN 规则、金额格式与文档冲突说明。
  • references/gomobi-ewallets-qr.md:Boost、GrabPay、ShopeePay、Touch 'n Go、DuitNow QR 与 7-Eleven 现金(EZYCASH)。
  • references/gomobi-cards-payout.md:银行卡支付、已保存卡(walletId)扣款与马来西亚打款。
  • references/gomobi-codes.md:FPX 银行代码、FPX 与银行卡响应码、打款 BIC 代码与错误信息列表。
  • references/account-setup.md:开通、凭证、沙箱与生产环境、环境变量名称、IP 白名单、结算与定价。
  • references/source-map.md:查找对应文档页面与覆盖范围。

使用方式

资料给出的核心工作流为:

  1. 识别环境(staging 的 m-uat.gomobi.io 系列或生产主机)与产品类型:托管收银台、FPX 直连、银行卡、电子钱包、DuitNow QR、现金或打款。
  2. 确认 Mobi 已为该产品签发对应凭证:mobiApiKey、loginId、mobiSecretKey、salt、FPX param1/param2、mid/tid、subMID,或 checkout API key 加 API secret。
  3. 在调用 Mobi 前,先在本地创建带唯一订单号/发票号的待支付记录。
  4. 在服务端按 gomobi-api.md 中该产品确切的签名或加密方案构建请求。
  5. 重定向客户(checkout_url、FPX 表单、银行卡表单、钱包 URL)或展示二维码。
  6. 浏览器重定向或回调页面仅作为用户体验处理。
  7. 在 IPN 校验通过后结算(解密或重算签名、核对金额、订单号、状态),再用状态 API 确认。
  8. 在文档规定的过期时间加 5 到 10 分钟后重新查询待支付记录,不要过早标记失败。
  9. IPN 处理需基于 Mobi 的交易 id 与自有订单 id 实现幂等。

关键事实

  • 托管收银台:POST https://middleware.gomobi.io/api/payment/v2/checkout/init(staging 为 https://checkout.gomobi.io/...),Bearer base64 API key,X-Signature 为对 METHOD + PATH + TIMESTAMP + NONCE + SHA256(body) 的 HMAC-SHA256,会话有效期 10 分钟,单次使用。
  • AES-CBC:AES/CBC/PKCS5Padding,key = PBKDF2WithHmacSHA256(mobiKey 或 param1, salt 或 param2, 65536 次迭代, 256 位),随机 16 字节 IV,输出 base64(IV || ciphertext)。
  • 3DES:DESede/ECB/PKCS5Padding,key 取 mobiSecretKey 前 24 字节,明文为 mobiKey,输出 base64。用于 DuitNow QR 与 EZYCASH 的 mobiApiKey 请求头,以及解密打款 IPN 和 FPX POST IPN 签名。
  • FPX:B2C 为 RM1 至 RM30,000,B2B 为 RM2 至 RM1,000,000,15 分钟过期,成功条件为 fpx_debitAuthCode 为 00。
  • 金额:电子钱包、银行卡与 FPX 状态使用 12 位 sen 字符串(000000001000 = RM10.00);checkout、FPX 存款、DuitNow、现金与打款使用十进制 MYR。
  • 过期时间:FPX 15m、Grab 15m、TNG 10m、ShopeePay 5m、Boost 5m、DuitNow QR 5m、现金 48h。
  • 通用代码:0000 成功,0001 失败。
  • 沙箱 FPX:银行 "SBI Bank A",用户 1234,密码 1234。沙箱银行卡:5452 0100 0009 5323,CVV 123,有效期 12/28。仅限沙箱。
  • 文档未记录退款或作废 API;FPX 退款需通过 Mobi 人工处理。
  • Mobi 无法手动重发回调。
  • 支持邮箱:csmobi@gomobi.io(IPN IP 列表、支持)、getsupport@gomobi.io(checkout API secret)。门户:https://gomobi.io/portal/login。

限制与注意事项

  • mobiApiKey、mobiSecretKey、salt、param1/param2 与 checkout API secret 仅保存在服务端,不得出现在前端代码中。
  • 不得使用文档示例密钥,应使用 Mobi 签发、来自环境变量的值。
  • 不得仅凭重定向页面、回调表单提交或二维码展示就发货或履约。
  • 每个 IPN 都需校验:解密 responseSignature/payoutEncryptedResponse,或重算 transaction_signature,然后核对订单号、金额单位、状态与子商户。
  • 高价值订单在履约前需用状态端点确认。
  • 将 Mobi 的 IPN IP 加入白名单(向 csmobi@gomobi.io 索取列表)作为加固措施,而不能替代校验;打款及部分生产端点在 Mobi 侧受 IP 限制。
  • 不得混用 staging 与生产主机及错误凭证。
  • 文档存在冲突处需在沙箱测试并向 Mobi 确认后再上线。
  • 不陈述费用;定价未公开。

完成标准

集成完成的判定条件包括:请求在服务端按该产品文档规定的签名、校验和或加密构建;重定向或展示二维码前已存在本地待支付记录;IPN 端点已在 Mobi 注册、可经 HTTPS 访问并加入白名单;IPN 处理完成校验或解密、核对金额订单号状态并具备幂等;状态重查询覆盖遗漏 IPN 与过期后的待处理状态;测试覆盖错误签名/校验和、错误金额单位、重复 IPN、待支付转成功、过期、失败与成功;部署文档列出环境变量并区分 staging 与生产。

尚未明确的事项

当被问及某 GoMobi 策略是否"100% 确信"时,资料建议执行漏洞审查循环,并指出以下仍存在不确定性或文档未说明的领域:银行卡加密方式、Boost/Grab/Shopee/TNG 的 POST IPN 签名顺序、Grab 的 tid/sessionId 握手、checkout body-hash 编码、IPN 重试策略与退款。