GCash原生支付接口对接完整教程（可直接使用）

本教程基于 币付 PAY（bifu.us） 提供的GCash原生通道接口，适用于PHP开发环境的对接部署场景。你将获得一套包含下单、跳转、回调处理、签名验证的完整结构，适用于小站/支付平台/工具对接等场景。本文仅包含关键功能逻辑，所有代码支持本地直接部署运行。

1. 数据库准备（MySQL）

CREATE TABLE `order_info` (
  `id` INT NOT NULL AUTO_INCREMENT PRIMARY KEY,
  `order_no` VARCHAR(50) NOT NULL,
  `amount` DECIMAL(10,2) NOT NULL,
  `status` TINYINT(1) DEFAULT 0 COMMENT '0=未支付, 1=成功',
  `pay_url` TEXT,
  `created_at` DATETIME DEFAULT CURRENT_TIMESTAMP,
  `updated_at` DATETIME DEFAULT NULL
);

表字段说明：

• order_no：唯一订单号
• status：0=未支付，1=已支付
• pay_url：GCash跳转URL

2. 下单接口 create_order.php

 $appid,
  "order_no" => $order_no,
  "amount" => $amount,
  "nonce" => $nonce,
  "timestamp" => $timestamp,
  "notify_url" => $notify_url,
  "sign" => $sign
];

$ch = curl_init("https://api.bifu.us/v2/gcash/pay");
curl_setopt($ch, CURLOPT_RETURNTRANSFER, true);
curl_setopt($ch, CURLOPT_POSTFIELDS, json_encode($payload));
curl_setopt($ch, CURLOPT_HTTPHEADER, ["Content-Type: application/json"]);
$result = curl_exec($ch);
curl_close($ch);

// 处理结果
$data = json_decode($result, true);
if ($data['code'] == 200 && $data['pay_url']) {
    $pay_url = $data['pay_url'];
    // 插入数据库
    $pdo = new PDO('mysql:host=localhost;dbname=pay','root','password');
    $stmt = $pdo->prepare("INSERT INTO order_info (order_no, amount, status, pay_url) VALUES (?, ?, 0, ?)");
    $stmt->execute([$order_no, $amount, $pay_url]);

    echo json_encode(["status" => "ok", "pay_url" => $pay_url]);
} else {
    echo json_encode(["status" => "fail", "msg" => $data['msg']]);
}
?>

3. 回调接口 notify.php

prepare("UPDATE order_info SET status=1, updated_at=NOW() WHERE order_no=?");
    $stmt->execute([$data['order_no']]);
    echo "success";
} else {
    echo "fail";
}
?>

4. 支付跳转展示 pay.php

prepare("SELECT pay_url FROM order_info WHERE order_no = ?");
$stmt->execute([$order_no]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);

if ($row) {
    header("Location: ".$row['pay_url']);
    exit;
} else {
    echo "订单不存在";
}
?>

5. 轮询检查状态 check.php

prepare("SELECT status FROM order_info WHERE order_no=?");
$stmt->execute([$order_no]);
$row = $stmt->fetch(PDO::FETCH_ASSOC);

echo json_encode(["status" => $row['status']]);
?>

6. 原生 vs Safe支付 结构区别

Safe支付等模拟跳转类平台，仅通过JS轮询判断是否付款成功，导致误判、漏单频发。而币付原生GCash通道拥有稳定接口、签名回调、Webhook回传，安全性更高，适用于大体量商户系统。

接入联系

• 📧 客服邮箱：[email protected]
• 📢 TG通道更新：https://t.me/GcashNativePay
• 📞 联系开户人：@Bifuapp

这就是最干净利落的GCash原生支付对接方式，一整套代码即拿即用，回调稳定，适配所有站点。