VmShellPAY

VmShellPAY 是由 VmShell INC 打造的跨境支付中台与商户财务管理平台，定位于连接上游支付通道、下游商户、终端付款用户之间的综合型支付基础设施。平台面向需要接入支付宝、微信支付及港币收款能力的跨境电商、数字服务、SaaS 平台、会员系统、自动售货系统、独立站和线下收款商户，提供从商户入驻、应用审核、API 接入、订单支付、交易查询、退款处理、争议管理、钱包结算、风控审计到财务报表的全流程能力。

从商业定位来看，VmShellPAY 不是单一收银页面，而是一个可运营、可管理、可拓展的支付中转平台。平台位于上游支付机构与下游商户之间，通过统一网关封装上游复杂的接口、签名、回调、退款和通道差异，让商户只需要对接 VmShellPAY 的标准 API，即可使用支付宝香港、支付宝大陆、微信支付等收款方式。平台支持港币 HKD 作为统一结算币种，便于跨境业务进行清晰的价格、手续费、退款和结算管理。运营方可在后台设置商户费率、退款手续费、结算周期、应用权限和风险策略，从支付服务差价与增值管理能力中获得商业收益。

从技术架构来看，VmShellPAY 采用 PHP 源码部署，运行在独立服务器环境中，适合宝塔、Nginx、PHP、MySQL 等传统稳定架构。系统围绕支付订单、商户应用、钱包流水、上游通道、下游回调、风控日志、邮件通知、系统审计等模块设计。平台提供正式环境与下游沙箱环境的分离能力，沙箱数据用于商户接入验证，不干扰正式交易与财务统计。正式交易只统计真实支付成功和退款成功的数据，其余处理中、失败、测试、演示订单保留在数据库中，后续可用于行为分析和风险评估。

平台的核心网关能力包括统一下单、直接二维码支付、查单、退款、部分退款、回调通知、退款通知、争议通知和签名验证。商户可以通过 AppId 与 AppSecret 调用接口，平台支持 HMAC-SHA256 签名、防重放 nonce、时间戳校验、IP 白名单、重复订单号检测和事件锁定机制，降低请求被篡改、重复提交、伪造回调或重复处理的风险。支付成功后，平台会同步更新订单状态，写入商户钱包流水，并向商户 notify_url 发送支付通知；退款成功后，同步更新退款状态、扣减商户余额、记录退款手续费，并通知商户退款接口。

从支付功能来看，平台目前聚焦三类正式通道：支付宝香港、支付宝大陆和微信支付。支付宝通道基于 HKD 场景区分 paymentInst=ALIPAYHK 与 paymentInst=ALIPAYCN，使商户可根据付款用户地区选择不同支付方式。微信支付支持扫码等场景，平台对上游返回的二维码、支付链接、订单状态、上游交易号进行统一存储与展示。商户侧无需直接暴露上游信息，前端统一展示为 VmShellPAY 支付能力，保护平台与上游合作关系。

从商户功能来看，前端支持普通用户、商户申请、主体资料提交、应用接入申请、沙箱联调、正式环境审批、交易流水查看、订单详情、退款申请、钱包余额、提现账户管理、提现申请、争议中心、工单、论坛交流、API 文档、源码插件下载等功能。普通用户只能访问基础资料、争议、工单和商户入驻流程；只有通过后台审核成为正式商户后，才可使用正式收款、应用凭证、交易流水、钱包和提现功能。商户可以查看每笔订单的付款邮箱、金额、支付方式、状态、手续费、退款记录、回调状态、上游交易号和钱包影响。

从后台运营来看，管理员可管理商户资料、商户审批、应用审批、上游网关配置、支付通道、手续费规则、钱包流水、提现审核、退款处理、争议处理、工单回复、邮件模板、SMTP 设置、系统日志、操作审计、系统备份、Webhook 监控、API 安全、风控报告、对账中心、利润报表和销售报表。后台所有关键操作，如修改费率、修改网关、审批商户、手动退款、调整钱包、处理争议等，都应记录操作人、IP、时间和前后值，满足正式商用环境下的审计要求。

财务体系是 VmShellPAY 的重点能力之一。平台按真实成功支付和真实退款生成钱包流水，包括支付入账、手续费扣除、退款扣除、退款手续费、提现冻结、提现完成等记录。商户钱包展示可用余额、待结算余额、冻结金额、累计交易、退款金额、手续费明细和提现记录。后台财务报表可统计平台利润、商户贡献利润、通道成本、商户费率差价、退款手续费、交易趋势和结算情况，帮助运营方判断收入结构与业务质量。

风控与对账方面，平台支持同邮箱高频支付、同 IP 高频失败、异常金额、重复订单号、短时间多次退款等风险识别，并可为后台生成风险分和处理建议。对账中心用于比对平台订单、上游订单、商户回调状态，自动发现上游成功但平台未成功、平台成功但商户未通知、退款状态不一致等异常，提升支付链路稳定性。Webhook 监控可记录通知成功率、失败原因、重试状态和异常告警，结合 SMTP 邮件提醒，便于正式上线后的持续运维。

生态拓展方面，VmShellPAY 提供 PHP 接入 Demo、直连二维码测试源码、查单示例、退款示例、回调验签示例、错误码说明，并规划或支持 WHMCS、WordPress、V2Board、独角数卡等常见系统的支付插件。平台还部署 Swagger UI 作为开放 API 管理与联调中心，方便商户保存全局 AppId、AppSecret，在线查看接口参数并测试调用。与此同时，VmShellPAY iOS App 面向普通用户与商户提供移动端财务查看、交易流水、钱包、服务政策、设置、多语言、Face ID 登录、商户应用状态和资金分析等能力，使商户可以在手机端查看经营数据。

总体而言，VmShellPAY 的目标是成为一个面向跨境场景的轻量级但完整的支付运营平台。它既解决下游商户接入多种支付方式的技术复杂度，也为平台运营方提供费率管理、风险控制、财务结算、商户审核和利润分析能力。通过统一 API、统一 HKD 结算、统一后台运营和移动端管理，VmShellPAY 可以帮助中小商户更快上线跨境收款，也让平台方具备持续运营、合规管理和商业变现的基础。