如何通过GCash API接入菲律宾支付系统

为了帮助商户快速接入支付系统，本文详细介绍了如何获取API Key、如何进行API签名和常用接口的使用方法。通过这些步骤，商户可以轻松集成支付功能，支持代收代付、订单查询等多种服务。

1. 获取API Key

• 登录收银台 -> 开发者中心 -> API Key -> 创建API Key。

• 每个API Key有独立的配置页面，支持绑定固定IP地址（0.0.0.0表示任何IP都可访问）。

• 请妥善保管Access Key和Secret Key，确保安全。

1.1 创建API Key

• 进入开发者中心，选择“API Key”并创建新的API Key。

• 配置调试模式、API Key权限和白名单地址。

• 创建后请保存Secret Key，因生成后无法查看。如遗忘，可回收密钥并申请新密钥。

2. 如何使用API Key

• 在请求头中添加以下参数：

• access_key：API Key

• timestamp：时间戳（13位）

• nonce：UUID（36位）

• sign：签名（通过HMAC_SHA1加密Base64编码）

3. 技术接入流程

• 根据API文档配置参数并进行接入。

4. 接口签名

• 为确保请求未被篡改，私有接口需通过API Key进行签名认证。

• 签名步骤：

• 定义Map字典，将请求参数与access_key、timestamp、nonce一起排序。

• 使用secret_key进行HMAC_SHA1加密并Base64编码生成sign值。

5. 接口列表

5.1 测试接口连通性

• 请求URL：/ping

• 响应：{"version": "1.0.1", "timestamp": 1688116827306}

5.2 创建代收订单

• 请求URL：/api/v3/ph/createCollectingOrder

• 请求方式：POST

• 请求参数：

• amount：收款金额（最大两位小数）

• channelType：支付类型（如QRIS、WALLET、BANK）

• externalOrderId：商户订单号

• notifyUrl：通知回调URL

• 响应数据：

• cashierUrl：收银台链接

• currency：货币类型（如PHP）

• orderId：系统订单ID

5.3 创建代付订单

• 请求URL：/api/v3/ph/createTransferOrder

• 请求方式：POST

• 请求参数：

• currencyAmount：代付金额

• channelType：支付方式（如BANK）

• BankName：银行或支付平台名称

• AccountNo：收款银行账号

• UserInfoName：收款人姓名

• UserInfoNo：收款人电话号码

• 响应数据：

• orderId：系统订单ID

• orderStatus：订单状态（如已受理）

  

5.4 查询代收订单

• 请求URL：/api/v3/ph/query/collectingOrder

• 请求方式：POST

• 请求参数：

• externalOrderId：商户订单号

• orderId：系统订单号

• 响应数据：

• orderStatus：订单状态

• orderAmount：订单金额

• currencyType：货币类型

5.5 查询代付订单

• 请求URL：/api/v3/ph/query/transferOrder

• 请求方式：POST

• 请求参数：

• externalOrderId：商户订单号

• orderId：系统订单号

• 响应数据：

• orderStatus：订单状态

• currencyType：货币类型

• errorMsg：错误信息

5.6 查询余额

• 请求URL：/api/v3/ph/query/balance

• 请求方式：GET

• 响应数据：

• accountBalance：账户余额

• accountFreezeAmount：账户冻结金额

• accountStatus：账户状态

5.7 查询银行列表

• 请求URL：/api/v3/ph/query/bankList

• 请求方式：POST

• 响应数据：返回支持的银行信息列表

6. 回调信息

• 支付回调、代付回调与验签步骤可参考API文档详细内容。