本篇文档旨在为各类菲律宾线上平台(网站、App、小程序等)提供完整的GCash原生支付接口说明。币付系统支持多支付方式调度(GCash、USDT、银行卡),具备完善风控、稳定监听与高转化设计,本文为技术开发者提供标准API字段说明与调用示例,便于快速部署与上线。
一、基础参数配置
参数名称 | 说明 | 类型 | 示例 |
---|---|---|---|
merchant_id | 商户编号 | string | BIFUAPP001 |
api_key | 商户私钥 | string | 2fb3a938cb1ad8c8e1... |
gateway_url | 网关地址 | string | https://www.250l.com/api/pay |
所有接口请求均使用 POST 方式,Header 推荐 Content-Type 为 application/json。
二、创建支付订单 API
请求地址:
POST https://www.250l.com/api/pay/create
请求参数:
字段 | 说明 | 类型 | 是否必填 |
---|---|---|---|
order_id | 商户订单号(唯一) | string | 是 |
amount | 支付金额(单位 PHP) | float | 是 |
pay_type | 支付方式:gcash / usdt | string | 是 |
notify_url | 支付成功后异步回调地址 | string | 是 |
return_url | 支付完成后跳转地址 | string | 否 |
sign | 参数签名 | string | 是 |
签名规则:
将以下字段按顺序拼接:order_id + amount + pay_type + notify_url + api_key
,然后使用 MD5 加密,转小写。
返回示例(JSON):
{ "code": 200, "msg": "success", "data": { "order_id": "BF1234567890", "pay_url": "https://www.250l.com/qrcode/BF1234567890" } }
三、支付成功回调接口
说明:支付完成后,系统将向商户 notify_url
POST 一次支付结果。
回调字段:
字段 | 说明 | 类型 |
---|---|---|
order_id | 原始订单号 | string |
amount | 实际到账金额 | float |
status | 状态(固定为 success) | string |
txid | 交易单号/转账码 | string |
sign | 签名字段 | string |
签名校验规则:
字段拼接顺序:order_id + amount + txid + api_key
→ MD5 → 小写。
回调响应要求:
商户系统需返回:success
(不区分大小写),否则视为未接收,币付系统将再次回调。
四、常见状态码说明
状态码 | 含义 | 说明 |
---|---|---|
200 | 成功 | 请求处理成功 |
400 | 参数错误 | 缺少必填字段 |
403 | 签名错误 | sign无效 |
500 | 服务异常 | 接口故障或超时 |
五、附加说明
- 所有金额单位均为菲律宾披索 PHP,小数点后最多两位
- 建议在订单生成后10分钟内完成支付,过期二维码会失效
- 建议启用 自动补单接口 或使用 系统通道状态订阅 提升稳定率
六、技术对接支持
- 技术对接TG:
@Bifuapp
- 更新频道:https://t.me/GcashNativePay
- 客服邮箱:[email protected]
GCash系统接入,从币付API开始。
稳定、安全、高效,助力您的支付闭环系统真正落地。
发表评论
发表评论: