使用教程

<script src="http://tkhuichuan.xcentre.top/assets/tracker.js" data-endpoint="http://tkhuichuan.xcentre.top/api/collect.php" data-project-id="你的项目ID"></script>

<script>
  // 浏览器只上报点击/浏览，业务成功事件使用服务端 API
  表单按钮点击();
  关键页面浏览();
</script>

<?php
session_start();

// 广告首次到站时保存百度点击标识和原始落地页，支付回调本身通常没有 bd_vid。
$bdVid = isset($_GET['bd_vid']) && is_string($_GET['bd_vid']) ? trim($_GET['bd_vid']) : '';
if ($bdVid !== '' && strlen($bdVid) <= 255 && !preg_match('/\s/', $bdVid)) {
    $_SESSION['baidu_bd_vid'] = $bdVid;
    $_SESSION['baidu_page_url'] = 'https://' . $_SERVER['HTTP_HOST'] . $_SERVER['REQUEST_URI'];
}

// 创建订单时把这两个值写入订单表；字段名可按你的项目调整。
$orderData['baidu_bd_vid'] = $_SESSION['baidu_bd_vid'] ?? '';
$orderData['baidu_page_url'] = $_SESSION['baidu_page_url'] ?? '';

<?php
/** 支付成功后调用百度回传系统；同一支付订单始终使用同一个 requestId。 */
function huiChuanBaiduZhiFu(array $order): array
{
    $apiUrl = getenv('BAIDU_RETURN_API_URL');
    $apiKey = getenv('BAIDU_RETURN_API_KEY');
    if (!$apiUrl || !$apiKey) {
        throw new RuntimeException('未配置百度回传 API 地址或密钥');
    }

    $projectId = (int)getenv('BAIDU_RETURN_PROJECT_ID'); // 项目管理中查看项目 ID
    $payload = array(
        'projectId' => $projectId,
        'requestId' => 'payment:'.$projectId.':' . $order['pay_channel'] . ':' . $order['order_no'],
        'orderId' => $order['order_no'], // 同域名内唯一订单号，跨请求标识去重
        'newType' => 90, // 商品支付成功；服务购买成功改为 10
        'bdVid' => $order['baidu_bd_vid'],
        'pageUrl' => $order['baidu_page_url'],
    );
    // newType=10 时可增加：$payload['convertValue'] = (int)$order['amount_fen'];

    $curl = curl_init($apiUrl);
    curl_setopt_array($curl, array(
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($payload, JSON_UNESCAPED_UNICODE),
        CURLOPT_HTTPHEADER => array(
            'Authorization: Bearer ' . $apiKey,
            'Content-Type: application/json',
        ),
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_CONNECTTIMEOUT => 3,
        CURLOPT_TIMEOUT => 12,
    ));
    $body = curl_exec($curl);
    $error = curl_error($curl);
    $httpCode = (int)curl_getinfo($curl, CURLINFO_HTTP_CODE);
    curl_close($curl);

    if ($body === false) {
        throw new RuntimeException('百度回传系统网络错误：' . $error);
    }
    $result = json_decode($body, true);
    if ($httpCode !== 200 || !is_array($result) || empty($result['success'])) {
        throw new RuntimeException('百度回传失败 HTTP ' . $httpCode . '：' . $body);
    }
    return $result;
}

// 支付异步通知：必须先验签、核对金额，并把订单状态更新为已支付。
// $order = verifyPaymentAndMarkPaid($_POST);
if (!empty($order['baidu_bd_vid']) && !empty($order['baidu_page_url'])) {
    $returnResult = huiChuanBaiduZhiFu($order);
    // 保存 $returnResult['recordId']，便于和回传系统后台记录核对。
}