SMARTPAY

QRPH 商户接入完整 Checklist:从申请到首笔收款(2026)

QRPH 商户接入不是"申请通过就能收款",中间要走完材料、审核、沙箱联调、灰度上线、正式运营五个阶段。本文给出一份可以直接照着执行的商户视角 Checklist,而不是只讲协议和字段的技术文档。

一、为什么商户接入 QRPH 需要一张 Checklist

网上能找到的 QRPH 资料,大多是写给开发者或研究人员看的协议说明:报文格式、字段字典、签名算法。这些内容对已经在写代码的工程师有用,但对要负责"让收款尽快上线"的商户负责人、运营或财务同事来说,读起来门槛高、也对不上自己手上的工作,缺的是另一样东西——一张能拿去对照执行、知道现在卡在哪一步、下一步该找谁的清单。这篇文章按实际接入顺序,把每个阶段该准备什么、该验证什么、通过标准是什么都列清楚,商户负责人和技术团队可以各自对照自己那部分执行,减少来回沟通的成本。

二、阶段一:申请与审核 Checklist

材料清单

  • 营业主体资料:SEC/DTI 注册证明、营业执照
  • 税务资料:BIR 2303、近期税务申报记录
  • 结算账户:与商户主体名称一致的银行账户
  • 实控人与董事 KYC:护照、身份证明文件
  • 行业专项资质:游戏、跨境电商等特殊类目对应的备案或许可
  • 官网或小程序等业务真实性佐证材料

常见审核意见

审核被打回,多数集中在三类原因:经营地址或范围与实际业务对不上、结算账户户名与主体名称不一致、行业类目不在收单方可承接名单内。提前对照这三类自查一遍,能省掉一整轮来回补件的时间,尤其是结算账户户名不一致这一条,很多商户直到被打回才发现自己用的是个人账户而不是公司对公账户。

三、阶段二:沙箱联调 Checklist

材料通过后进入沙箱环境,建议把以下五类场景逐一测试完,而不是只测"正常支付成功"这一条路径:

  1. 正常下单并支付成功,验证回调通知与签名字段完整
  2. 用户主动取消或支付超时,验证订单状态能正确置为失败或关闭
  3. 模拟回调超时或丢失,验证主动查询接口能拿到与实际一致的状态
  4. 重复提交同一订单号,验证幂等处理不会重复入账
  5. 发起全额与部分退款,验证退款结果通过回调正确通知

沙箱调试示例

curl -X POST https://sandbox.yourgateway.com/v1/qrph/order/create \
  -H "Content-Type: application/json" \
  -d '{
    "mid": "SANDBOX-MID-001",
    "out_trade_no": "QA20260928001",
    "amount": "100.00",
    "currency": "PHP",
    "notify_url": "https://yourshop.com/qrph/callback",
    "sign": "替换为沙箱密钥计算的签名"
  }'

# 主动查询兜底
curl -X GET "https://sandbox.yourgateway.com/v1/qrph/order/query?out_trade_no=QA20260928001&mid=SANDBOX-MID-001&sign=签名"

四、阶段三:上线与运营 Checklist

灰度上线验证

拿到生产密钥后不要直接全量切换,建议先用小范围真实订单跑一遍完整链路:下单、支付、回调、对账文件是否都能对上,确认无误再逐步放量。灰度阶段建议覆盖不同金额档位和至少一次退款场景,发现的问题在这个阶段修复,成本远低于全量上线后再回头排查。

上线后运营清单

  • 建立每日对账流程:交易流水与对账文件逐笔核对,差错当日处理
  • 配置回调失败告警:超过约定时间未收到回调,自动触发人工核查
  • 密钥定期轮换机制:明确轮换周期与旧密钥失效时间
  • 建立错误码监控看板:异常错误码占比升高时及时介入排查

五、完整 Checklist 总览表

阶段关键任务负责方通过标准
材料准备主体、税务、KYC、行业资质商户材料齐全且信息互相一致
审核提交递交收单方或网关审核商户 + 网关审核意见清零,拿到沙箱账号
沙箱联调五类场景全部测试通过商户技术团队下单、回调、查询、退款结果一致
灰度上线小额真实订单验证商户 + 网关全链路无异常,对账无差错
正式运营日常对账与监控告警商户异常能被及时发现并处理

六、通过 SMARTPAY 走完整个 Checklist

这份 Checklist 里最容易卡壳的环节,通常是材料审核的沟通往返和沙箱联调的技术细节。持牌四方网关的价值,在于提供统一的接入文档和专职联调支持,商户按清单推进,遇到问题有人及时确认。可先读 QRPH 商户开通要什么条件 了解材料与资质要求,或看 QRPH 商户 API 接入 了解接口与验签细节;通用接入思路也可参考 菲律宾支付 API 怎么对接,不确定该选哪种接入方式,也可以先读 菲律宾支付网关怎么选 理清思路。

SMARTPAY 是持 BSP OPS/EMI 牌照的独立支付网关,提供 QRPH 等通道的商户接入与联调支持服务,非 QRPH 官方发行方。

七、常见问题

Checklist 每一项都要走完才能上线吗?

建议都走完。跳过沙箱阶段的某类场景测试,往往会在真实收款后才暴露问题,那时候排查成本比联调阶段高很多。

材料审核大概需要多久?

材料齐全、行业无特殊限制,走持牌网关通常几个工作日能进入沙箱联调;涉及特殊行业备案的,周期会相应拉长。

沙箱测试通过就能直接全量上生产吗?

不建议。先做灰度小额验证,确认真实链路无误后再逐步放量,能提前发现沙箱环境覆盖不到的问题。

Checklist 里的对账要多久做一次?

建议按日对账。交易量大的商户可以按小时做初步核对,日终再做一次完整对账,缩短差错发现的时间差。

换了收单方或网关,Checklist 需要重新走一遍吗?

核心流程一致,但具体字段、签名算法和沙箱环境通常不同,建议按新网关的文档重新完整测试一遍,不要直接复用旧的联调结果,尤其是签名算法和回调应答格式,这两处最容易出现看似能跑通、实际藏着隐患的情况。

个体商户和公司主体的 Checklist 有区别吗?

材料清单会有差异,个体商户通常需要额外的经营者身份证明,具体要求以收单方或网关的审核结论为准。

八、快速接入

想要一份可以直接照着执行的 QRPH 接入 Checklist,并有专职工程师陪跑联调,欢迎联系 SMARTPAY:📩 [email protected] | Telegram @LouisSMARTPAY

相关推荐