WJPAY支付通道接入指南：GCash 与 Maya 收款、快速结算、回调对账｜币付 Bifu

在菲律宾做线上收款，商户最关心的通常是三件事：支付成功率、资金结算效率、对账与风控可控性。币付（Bifu）为商户提供 WJPAY 支付通道 接入服务，覆盖 GCash 与 Maya（含 PayMaya 品牌关键词）等本地主流电子钱包，适配电商、游戏、数字内容、订阅服务等业务，帮助你更稳定、更清晰地完成收款与资金流转。

一、WJPAY 通道适合哪些商户

面向菲律宾用户：用户偏好使用 GCash、Maya 完成支付。
对成功率与稳定性有要求：希望减少失败率、掉单、回调不稳定、对账困难等问题。
需要标准化对账口径：财务希望用统一字段核对订单、交易号、金额、状态与结算数据。
希望链路更可控：通过 API 形成下单、支付、回调、查单、对账的闭环，便于监控与追责。

二、核心能力概览：GCash 与 Maya

1）本地主流钱包覆盖

支持 GCash、Maya 收款，开通范围以实际审核与通道配置结果为准。
可根据业务类型、客单价与风险等级，配置更合适的收款策略。

2）结算与资金流转更灵活

支持按业务需求配置结算节奏与结算账户信息，提升资金周转效率。
配合对账字段与结算规则，降低财务核对成本与争议处理成本。

3）标准化对账能力

支持订单维度的支付状态查询、回调通知与对账数据输出。
建议统一使用商户订单号、平台交易号、渠道交易号、金额、状态、时间戳等字段做核对与追踪。

4）异常处理与风控思路

支持重复订单拦截、订单有效性校验、频控、黑名单等基础策略，具体以通道能力与配置结果为准。
建议建立回调补偿与查单兜底机制，降低支付成功但商户侧未入账的风险。

三、接入流程：从资料到上线

提交资料：主体信息、业务说明、收款场景、结算信息、网站或应用链接等。
开通与配置：分配商户号与密钥，配置回调地址 notify_url，设置支付方式与风控策略。
联调测试：验证下单、支付、回调、查单、对账全链路，并覆盖异常场景。
上线运营：建议启用日志与告警，重点监控成功率、回调到达率、异常订单占比与退款争议数据。

四、技术对接要点：下单、回调、验签、幂等、查单、对账

1）下单接口建议字段

merchant_no：商户号
order_no：商户订单号，建议全局唯一
amount：订单金额，明确金额精度与最小单位规则
currency：币种，通常为 PHP
pay_method：支付方式，如 GCash、Maya
notify_url：支付结果回调地址，优先 HTTPS
return_url：前端跳转地址，用于展示支付结果
sign：签名字段，用于防篡改

2）回调通知 Webhook 的关键要求

必须验签：回调到达不代表可信，验签通过后再更新订单状态。
必须幂等：同一订单回调可能重复到达，订单进入已支付终态后禁止重复发货或重复入账。
建议二次确认：对高风险或高客单订单，回调验签后再查单确认，以最终查询结果为准。

3）查单兜底与对账口径建议

查单兜底：回调缺失或异常时，以订单查询结果结合商户侧订单日志进行状态校正。
日常对账：按订单号、交易号、金额、状态、完成时间核对；异常订单单独拉清单闭环处理。
差错定位：优先比对回调记录、查单结果、商户侧日志与时间线，快速判断归因与处理路径。

五、费率与成本展示：实时费率表

费率通常会因业务类型、交易量级、风险评估与结算方式不同而有差异。你可以先参考币付的实时费率表，查看 GCash 与 QRPH 的最新费率展示，再结合你的业务情况申请更合适的方案。

实时费率表：

[rate-table type="all"]

六、风控与合规建议

业务描述一致：落地页、商品或服务说明、退款规则要清晰，避免收款内容与实际不符导致风控拦截。
退款与撤销可追踪：保留订单状态变更记录、操作人、原因与时间戳，便于争议处理。
异常订单有处置策略：覆盖未回调、验签失败、金额不一致、重复支付、用户投诉等场景。
密钥与权限最小化：分环境隔离密钥，按角色分离权限，减少泄露带来的资金风险。

七、常见问题 FAQ

Q1：支付成功但商户没有收到回调怎么办

建议按顺序排查：回调地址是否可公网访问 → 商户是否返回正确响应 → 是否被防火墙或 WAF 拦截 → 验签是否通过 → 最后通过查单进行状态校正与补偿。

Q2：如何避免重复扣款或重复发货

关键是三件事：订单号唯一、回调幂等、终态保护。同一订单进入已支付终态后，禁止再次触发发货或充值逻辑。

Q3：单笔限额、结算周期、费率能否调整

可以。通常会结合商户业务类型与风险评估进行配置与调整，最终以实际开通与配置结果为准。

八、接入币付 Bifu：开通 WJPAY 通道与联调支持

如果你希望开通 WJPAY 通道并接入 GCash、Maya（PayMaya），获取对接文档与联调支持，请直接联系币付客服。我们会根据你的业务场景给出更合适的接入方案与风控建议。

Telegram：@Bifuapp
邮箱：[email protected]

为提升对接效率，建议你在沟通时准备：业务类型与收款场景、预计日交易量级、客单价范围、网站或应用链接、结算方式需求、技术栈信息。