币付GCash原生接口实战部署教程（含数据库结构与代码模板）

在菲律宾市场中，GCash原生接口是实现稳定收款的核心基础设施。与模拟脚本或第三方中转通道相比，币付原生API具备稳定回调、签名验证、防重放攻击等企业级特性，适用于电商站、支付系统、工具类业务集成。本文提供一整套GCash支付对接解决方案，包括数据库、下单逻辑、签名算法、回调处理、状态查询与前端展示，开发者可直接使用或扩展。

一、订单数据库设计

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

• order_no：全局唯一订单编号
• status：0未支付，1成功，2失败
• pay_url：跳转用的原生GCash支付链接

二、创建订单接口（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']);
$response = curl_exec($ch);
curl_close($ch);

$data = json_decode($response, true);
if ($data['code'] == 200 && isset($data['pay_url'])) {
    $pdo = new PDO("mysql:host=localhost;dbname=pay;charset=utf8", "root", "password");
    $stmt = $pdo->prepare("INSERT INTO gcash_order (order_no, amount, status, pay_url) VALUES (?, ?, 0, ?)");
    $stmt->execute([$order_no, $amount, $data['pay_url']]);
    echo json_encode(["status" => "success", "pay_url" => $data['pay_url'], "order_no" => $order_no]);
} else {
    echo json_encode(["status" => "fail", "msg" => $data['msg'] ?? '接口异常']);
}
?>

三、跳转/二维码页面（pay.php）

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

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

四、GCash异步回调接口（notify.php）

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

五、支付状态查询接口（check.php）

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

echo json_encode(["status" => $res['status'] ?? -1]);
?>

六、币付原生 vs safe支付的技术差异

safe支付一类平台仍使用网页模拟收款二维码技术，缺乏原生SDK支持和回调签名机制，极易被中间人劫持/掉单/伪回调。在生产环境中长期使用此类平台极不稳定。币付作为菲律宾本地GCash原生接入服务，具备API密钥签名机制、HTTPS通道保护、Webhook全自动通知能力，适配绝大多数平台集成标准。

接入币付 PAY

• 📧 客服邮箱：[email protected]
• 📢 官方TG频道：https://t.me/GcashNativePay
• 📲 联系开户：@Bifuapp

币付 PAY，让GCash原生支付真正做到可控、安全、高效。