SMARTPAY

GCash Business Portal 商户后台使用指南:登录、账户设置与常用功能

一、GCash Business Portal 是什么

GCash Business Portal 是 GCash 给商户的官方后台,面向商户运营、财务与技术三类角色。你在申请商户号成功后拿到的第一份"数字资产",除了 API key,就是这个 Portal 的登录账号。日常的收款查看、退款处理、员工权限、结算导出,基本都在这里完成。

Portal 的定位是"轻量运营台",不是完整 ERP:它给你一个统一入口看清资金流,但账务打通、订单联动、多通道对账仍要在自家系统里做。理解这个边界,才能把 Portal 用得顺手,而不是全靠它。

二、登录流程与账号安全设置

Portal 一般走网页 business.gcash.com(以商户经理提供的实际 URL 为准),流程遵循这一套:

  1. 浏览器打开 Portal 地址,输入商户主账号邮箱与初始密码
  2. 触发短信或 App 验证码,完成双因子验证(MFA)
  3. 首次登录必须修改初始密码,并绑定备用邮箱
  4. 建议同时启用 TOTP 类 2FA(Google Authenticator / Microsoft Authenticator),不要长期依赖短信
  5. 把 IP 白名单打开,只允许公司公网出口进入,能挡掉大部分暴力登录

账号安全是 Portal 使用的第一课。菲律宾本地钱包近年针对 KYC 与商户端的社工攻击不少,商户经理反复强调:主账号不共用、不发在群里、离职必换。做惯了大陆后台的团队,尤其要注意 GCash Portal 的短信验证在跨境网络下经常延迟,别在等验证码时反复点重发,可能触发风控。

三、常用页面导览

不同版本的 Portal 菜单命名会略有出入,功能分区基本稳定:

  • Dashboard(仪表盘):今日成交、今日笔数、退款、失败率、待结算余额,一屏看清资金流
  • Transactions(交易):全量成交列表,支持按时间、订单号、金额、状态、通道筛选,可 CSV 导出
  • Refunds(退款):发起退款、退款单跟踪、退款失败原因;部分商户需先申请退款权限
  • Settlements(结算):结算批次、到账银行、结算凭证、结算周期,财务对账主用页
  • Users & Roles(员工与权限):添加子账号、分配角色、审计操作日志
  • Developer(开发者):API key 管理、Webhook 配置、沙盒切换、密钥轮换
  • Reports(报表):多维度报表导出,常配合财务系统做二次处理

做多通道运营的团队,一定要养成"每天早晚各刷一次 Dashboard"的习惯,失败率与结算延迟的异常,通常先在这里露头。若把 GCash / Maya / QRPH 全交给一个网关聚合,能把这一步收拢到SMARTPAY 商户后台的多通道视图里。

四、员工与权限管理最佳实践

Portal 的角色体系一般涵盖:

角色典型权限适合岗位
Owner / Admin全部权限,含账号、密钥、结算创始人 / IT 负责人
Finance交易查看、结算导出、退款审批财务 / 会计
Operations交易查看、退款发起、订单核销运营 / 客服
DeveloperAPI key、Webhook、沙盒切换后端工程师
Read-only只看不能改审计 / 外部顾问

实操里的几条铁律:

  1. Owner 账号只保留一个,交给公司法人或极信任的联合创始人;不用它做日常
  2. 财务、运营、技术三条线分账号,操作日志能追溯到人
  3. 员工离职当天,先禁用账号再走离职流程,不要"下周处理"
  4. API key 与 Webhook secret 每季度轮换一次,并把旧值加入吊销名单
  5. 把 商户对账 的关键权限单独授权给财务,禁止运营触碰

五、常见操作示例

下面几个高频操作值得先做一遍熟悉。截图省略(占位),商户经理提供的操作手册里会有当前 UI 版本的图示。

  • 发起退款:Transactions → 找到订单 → Refund → 输入退款金额与原因 → 二次确认。原路退回,到账周期以 GCash 侧规则为准。
  • 结算凭证下载:Settlements → 选批次 → Download PDF/CSV。财务会把这份凭证和银行流水做逐笔对账。
  • Webhook 测试:Developer → Webhook → Send Test Event。先把回调地址跑通,再上生产;上线后监控 5xx 与延迟。
  • 密钥轮换:Developer → API Keys → Rotate。新旧 key 一段时间内并存,业务切换完成后禁用旧 key,不要直接删。
  • 批量导出:Reports → Custom Range → Export。大范围导出前先确认时区(GCash 用马尼拉时区,财务系统若用 UTC 要额外换算)。

六、通过 API 拉取后台数据

后台是给人看的,做规模化运营必须走 API。哪怕 GCash Portal 提供导出功能,人工导出也会有 T+1 延迟和文件粒度问题。正确姿势是把 Portal 里最常看的几张表通过 API 落到自己数据仓,做实时监控与自动对账。

下面是一段示意 curl 请求,用来拉取指定日期区间的成交明细,可放进 cron 每 15 分钟跑一次:

curl -X POST https://apix.example.com/api/v1/transactions/query \
  -H "Content-Type: application/json" \
  -H "X-Merchant-Id: MCH1000123" \
  -H "X-Sign: 3f7b1a2c9d..." \
  -d '{
    "channel": "GCASH_BIZ",
    "start_time": "2026-09-25 00:00:00",
    "end_time": "2026-09-25 23:59:59",
    "status": "SUCCESS",
    "page": 1,
    "page_size": 200
  }'

返回结构里通常包含 trade_no、支付时间、金额、通道、GCash 侧 reference、结算批次号。把 GCash 侧 reference 与结算批次号入库,后面做退款和账务追溯会省很多事。

七、SMARTPAY 统一后台 vs 官方 Portal 对比

单通道商户,GCash Business Portal 已经够用。多通道 + 规模化运营的团队,通常会在 Portal 之外再叠加一层统一后台。取舍如下:

维度官方 Portal(仅 GCash)SMARTPAY 统一后台
通道覆盖只看 GCashGCash + Maya + QRPH + 银行卡
对账维度单通道跨通道合并对账
员工权限GCash 一套角色跨通道统一角色
报表导出标准维度可自定义维度
WebhookGCash 单一回调统一回调格式,商户系统只对接一次
清算主体GCashSMARTPAY 持牌主体 → 商户结算 汇总
合规资质GCash EMISMARTPAY BSP OPS/EMI 双牌照
SMARTPAY 持 BSP OPS/EMI 双牌照,统一后台并不替代 GCash 官方 Portal,而是叠加一层多通道视图与合规结算;商户仍可随时登录官方 Portal 查看原始账单。

八、常见问题 FAQ 与快速开通

忘记 Portal 主账号密码怎么办?

点击登录页的 Forgot Password,通过绑定邮箱重置。若邮箱也无法访问,需要联系商户经理走人工验证,准备好法人身份与营业证明。

子账号看不到某些菜单是什么原因?

菜单可见性由角色权限控制,不是页面 bug。请管理员在 Users & Roles 检查该子账号的角色是否勾选了对应模块。

Webhook 一直收不到回调怎么排查?

四步:1)Developer 里发一个 Test Event,看是否 200;2)自己服务端 log 是否有请求进来;3)确认服务端返回 200 且响应体符合规范,否则 GCash 会重试并可能自动挂起;4)公网防火墙是否放行 GCash 出口 IP 段。

结算金额和 Dashboard 显示不一致怎么办?

Dashboard 一般显示"成交金额",结算金额是"扣手续费与冲正后的净额"。以 Settlements 页面的结算凭证为准,并结合 API 拉取的明细逐笔核对。

Portal 支持多商户号统一管理吗?

官方 Portal 是按商户号维度组织的,多商户号需要来回切换。想在一个后台管理多个 GCash 商户号 + 多通道,一般要走网关的统一后台。

API 接不通,后台却正常,怎么办?

先确认商户号是否已开启 API 权限、密钥是否在有效期、请求 IP 是否在白名单、签名字段顺序与算法是否与文档一致。若排除以上四点仍然失败,联系商户经理或网关技术支持。

能同时使用官方 Portal 与网关后台吗?

可以。两者并不冲突,商户可以在 GCash 官方 Portal 查看单通道原始账单,同时在网关统一后台看多通道汇总视图,两条路径互补。

想快速把 GCash 商户后台叠加到统一多通道视图,联系 SMARTPAY:📩 [email protected] | Telegram @LouisSMARTPAY

相关推荐