菲律宾聚合支付API对接指南

本开发文档旨在帮助商户系统（如在线购物、收银系统、智能收银系统等）对接菲律宾的聚合支付平台，支持包括GCash在内的本地支付方式。该文档适合开发、测试和运维等技术团队使用。

支付模式

• 扫码支付
  商户通过生成支付二维码，用户使用GCash或其他支付工具扫描二维码完成支付。适用于：

• 网站支付

• 实体店静态二维码支付

• 广告媒体二维码支付

• APP支付
  商户通过集成开放SDK，在APP内调用支付模块完成交易，适用于移动电商或服务类应用。

  

• 刷卡支付
  用户展示GCash或其他支付应用中的条码/二维码，商户扫描完成支付。主要用于线下场景，如超市或实体店收银。

• H5支付
  用户通过移动端浏览器访问商户页面，调用支付接口完成交易。适用于移动端在线购物或服务订购。

名词解释

• 聚合支付平台
  通过整合多种支付方式（如GCash）为商户提供便捷的支付服务。

• 签名验证
  确保数据传输安全，商户需计算签名值与平台校验值匹配，验证通过后方可完成请求。

• 同步返回
  平台处理支付请求后，立即跳转至商户指定的同步地址，展示订单处理结果。同步通知仅作为信息展示，具体业务逻辑以异步返回为准。

• 异步返回
  平台校验成功后，向商户提供的异步地址发送订单处理结果。商户需验证签名并按需处理业务逻辑。

• 应用ID（app_id）
  平台为每个应用分配的唯一标识，用于区分不同应用。

• 商户编号（mch_uid）
  平台为每个商户生成的唯一标识。

• 密钥（key）
  平台随机生成的加密密钥，用于接口签名验证和数据加密。

主要API功能列表

• 商户进件接口
  支持商户注册和账号审核，快速完成商户入驻。

• 聚合支付接口
  整合GCash等支付方式，支持实时支付和交易查询。

• 交易通知接口
  包括支付结果异步通知和退款通知，确保交易信息及时同步。

• 电子发票接口
  自动生成与管理支付相关的电子发票，符合菲律宾税务合规要求。

• 对账接口
  支持商户获取交易报表，方便财务对账与统计分析。

对接流程

1. 申请应用ID和密钥
   商户注册后，获取平台分配的app_id和key，用于后续接口调用。

2. 配置回调地址
   商户需提供同步地址（return_url）和异步通知地址（notify_url），确保交易信息及时返回。

3. 签名验证
   所有接口请求需包含签名字段，商户需按文档规则计算签名值，确保数据完整性。

4. 测试与上线
   使用平台测试环境进行接口联调，确保支付流程顺畅后，切换至生产环境。

联系我们

为确保支付对接顺利进行，商户可随时联系我们获取技术支持：

• 官网：bifu.us

• Telegram客服：Bifuapp

总结

该支付平台通过整合GCash等本地支付方式，为菲律宾市场提供便捷的支付服务。支持多场景支付模式和灵活的API接口，商户可快速实现系统对接，提升用户支付体验，推动业务发展。