GALApay 测试环境文档

GALApay 测试环境使用与对接说明
更新日期：2026-10-27（北京时间 UTC+08:00）

一、测试入口
总后台：https://test-admin.galapayglobal.com/
商户后台：https://test-merchant.galapayglobal.com/
本文档：/api/integration-doc?lang=zh

二、与生产环境的区别
本环境用于页面、权限、报表和模拟数据验收，与生产共用服务器，但使用独立进程、数据库、账号及加密密钥。不要使用生产密码、验证器、客户资料、银行卡、钱包账号或接口密钥。
页面顶部始终标有“测试环境 / TEST ONLY”。测试版代码不会自动同步生产，测试通过后再另行上线。

三、测试账号
总后台账号：admin；商户主账号：testmerchant。
初始密码通过专用私密资料交付，不在本文档公开。首次登录自行改密并绑定新的测试谷歌验证器。两个账号密码不同，不能跨端登录。
连续登录失败会触发测试环境IP锁定，请停止重复尝试，由维护人员仅在测试库核实解锁，不关闭登录保护。

四、模拟数据与验收范围
初始模拟商户 TEST-MERCHANT，站点 TEST-001（内部标识 TEST-SITE）；代收和代付各225笔模拟订单、225条模拟流水。页面操作后数量可能变化。
可以检查订单查询、筛选、多页翻页、每页条数、横向滚动、11种语言、弹窗、账变与流水显示。
查看与导出分别授权。子账号只可访问所属模拟商户；取消权限后，后续请求和历史报表下载应按当前权限校验。
无敏感资料导出权限时，相关字段应脱敏；订单号正常导出。不要上传真实客户资料进行验证。
测试账号权限和模拟数据可以用于验收；测试结果不能证明真实上游支付或群消息送达。

五、接口和对外操作限制
当前没有可下单的测试支付网关。/open/v1/ 路由关闭，不接受真实或模拟支付API请求；不要把测试域名填写到生产系统中。
真实支付、上游采集、订单回调投递、Telegram机器人和群通知均未启动；测试进程禁止外网访问。后台配置不能解除系统层的网络隔离。
/api/health 为只读健康检查，正常返回 environment=staging、payments=disabled、notifications=disabled。
GET /api/health 不需要登录；后台其他接口保留原有登录、角色权限和CSRF校验。生产接口协议请以另行交付的生产文档为准，不要把本文当作可用支付API凭据。

六、建议验收顺序
1. 确认域名以 test- 开头，顶部显示测试环境。
2. 使用对应测试账号完成首次安全设置。
3. 检查菜单折叠、页面跳转、语言切换及弹窗。
4. 使用模拟订单检查筛选、翻页、每页条数和导出。
5. 使用隔离子账号验证查看、导出及敏感资料权限和即时撤销。
6. 记录问题与复现步骤，测试通过后再单独安排生产发布。

七、数据及通知边界
全部测试写入只作用于独立模拟库；严禁把测试库回写生产。不要测试真实充值、转账、代付、回调重放或群消息发送。关闭或更新测试服务不应重启生产支付服务。