Share Commerce 支付网关集成技能
用途
用于 Share Commerce 在线支付网关(Share Commerce Sdn Bhd,吉隆坡)的集成工作,包括设置、构建、调试、审查和解释支付集成。目标是帮助开发者安全、正确地完成从请求构建到回调验证的完整流程。
主要能力
该技能提供以下能力:
- 识别环境:区分测试环境(stagingpayment.share-commerce.com)和生产环境(payment.share-commerce.com)。
- 识别支付界面:托管支付请求(/payment)、无缝 iframe(/seemlesspayment)、预授权(/CreateCheckout/PreAuth)、定期支付(/CreateCheckout/Recurring)或插件。
- 确认入驻信息:商户 ID、密钥、各环境测试凭据、服务器 IP 白名单、回调 URL 注册。
- 指导生成唯一商户订单号并创建本地待处理订单。
- 指导服务端构建请求并计算 SCSign 签名。
- 指导将浏览器重定向到网关或返回的 CheckoutUrl。
- 指导验证服务器到服务器回调的 SCSign 签名,并幂等结算。
- 指导使用 /enquiry 等查询接口作为回调缺失时的后备方案。
- 提供核心事实:API 端点、签名算法、响应码、金额格式、退款限制、官方插件列表等。
- 提供关键规则:密钥安全、签名精确性、回调验证、幂等结算等。
- 提供完成标准:确保集成满足安全与正确性要求。
- 提供漏洞审查循环:用于评估策略是否“100% 自信”,列出信任边界、检查绕过方式、添加修复措施。
使用方式
该技能通过自然语言交互使用,建议在开始事实性 API 指导或编写集成代码前,先阅读 references/share-commerce-api.md 以获取端点目录、请求/响应字段表、每个端点的 SCSign 算法及已验证示例、状态码枚举、支付方式代码和文档不一致之处。当用户询问入驻、凭据、测试与生产环境、IP 白名单、回调 URL 注册、插件或定价时,阅读 references/account-setup.md。当需要确定官方页面或插件文件依据时,阅读 references/source-map.md。
核心工作流程包括:识别环境与界面、确认入驻、创建本地订单、服务端构建请求并签名、重定向浏览器、仅将浏览器返回视为用户体验、验证回调签名并幂等结算、使用查询接口作为后备、重新检查金额、货币、订单号、商户 ID 和响应码。
适用场景
适用于需要集成 Share Commerce 支付网关的开发者、技术负责人或代码审查人员,尤其是在马来西亚市场开展在线支付业务的场景。可用于构建支付请求、调试签名问题、审查现有集成安全性、解释 API 行为等。
限制
以下事实暂未提供或需与 Share Commerce 确认:部分文档示例哈希无法复现、支付查询的签名输入、回调重试策略、无缝支付响应签名算法、退款可用性、定价和结算时间。此外,文档未提供退款 API,仅支持当日支付作废(Payment/Void,全额作废,响应 FULL_REFUNDED)。集成时必须使用服务端密钥,不可将密钥暴露给浏览器;签名必须基于发送的确切字符串和顺序;回调验证需使用原始 JSON 值并采用恒定时间比较;不得仅凭重定向结果履行订单。