You need to enable JavaScript to run this app. 如何通过Coinbase Commerce Webhook追踪自建网站的支付成功状态
优惠活动
大模型
产品
解决方案
定价
更多

如何通过Coinbase Commerce Webhook追踪自建网站的支付成功状态

Coinbase Commerce嵌入支付的交易追踪实现方案

问题1:现有嵌入代码是否会返回可用于追踪的唯一交易ID

  • 支持返回。每笔通过嵌入支付流程生成的实际支付账单,都会附带全局唯一的charge_id作为交易核心标识,这个ID是跨场景追踪支付状态的唯一依据。

问题2:基于现有嵌入代码的ID获取与状态追踪落地方法

针对不熟悉Composer依赖体系、但熟悉原生PHP和JS的情况,完全可以跳过第三方SDK的复杂配置,用原生代码实现完整的追踪流程:

前端JS层捕获交易ID与支付状态

当前嵌入的官方checkout.js脚本自带原生事件回调机制,不需要修改原有嵌入结构,只需在原有嵌入代码的末尾追加事件监听逻辑即可:

// 监听官方支付脚本抛出的状态事件
window.addEventListener('message', (event) => {
  // 仅接收Coinbase官方域名的消息,避免伪造请求风险
  if (event.origin !== 'https://commerce.coinbase.com') return;
  const payload = event.data;
  // 捕获支付账单创建事件,提取唯一交易ID
  if (payload.type === 'charge:created') {
    const chargeId = payload.data.id;
    // 将待支付的交易ID暂存到本地会话,关联当前用户的订单
    sessionStorage.setItem('pending_charge_id', chargeId);
  }
  // 捕获支付完成事件,将交易ID回传后端验证
  if (payload.type === 'payment:confirmed') {
    fetch('/api/verify-payment.php', {
      method: 'POST',
      headers: {'Content-Type': 'application/json'},
      body: JSON.stringify({ charge_id: payload.data.id })
    }).then(res => res.json()).then(verifyResult => {
      if (verifyResult.success) {
        // 验证通过后跳转商品交付页
        window.location.href = '/delivery-success.html';
      }
    })
  }
})

后端PHP层校验交易状态(无第三方依赖版本)

从GitHub下载的coinbase-commerce-php包本质是对官方接口的封装,不需要掌握Composer、vendor自动加载机制,用原生PHP的cURL就能实现同等功能,完全绕开不熟悉的依赖配置环节:

<?php
// 文件路径:api/verify-payment.php
// 解析前端传回的请求
$requestPayload = json_decode(file_get_contents('php://input'), true);
$chargeId = $requestPayload['charge_id'] ?? '';
if (!$chargeId) {
  exit(json_encode(['success' => false, 'msg' => '无效交易标识']));
}
// 替换为你在Coinbase Commerce后台生成的专属API密钥
$apiKey = '你的后台API密钥';
// 调用官方接口查询交易详情
$curlHandler = curl_init("https://api.commerce.coinbase.com/charges/{$chargeId}");
curl_setopt_array($curlHandler, [
  CURLOPT_RETURNTRANSFER => true,
  CURLOPT_HTTPHEADER => [
    "X-CC-Api-Key: {$apiKey}",
    "X-CC-Version: 2018-03-22"
  ]
]);
$interfaceResponse = curl_exec($curlHandler);
curl_close($curlHandler);
$chargeDetail = json_decode($interfaceResponse, true);
// 校验交易状态
if (
  isset($chargeDetail['data']['status']) && 
  in_array($chargeDetail['data']['status'], ['CONFIRMED', 'RESOLVED'])
) {
  // 核心校验逻辑:确认交易金额匹配订单应付金额、关联的用户信息无误
  // 将charge_id写入本地订单表,标记订单为已支付,避免重复交付
  // 交付完成后返回成功状态
  exit(json_encode(['success' => true]));
}
exit(json_encode(['success' => false, 'msg' => '交易未完成或状态异常']));

补充注意事项

  • 所有支付状态校验必须在后端完成,不能仅依赖前端传回的状态值,避免被篡改绕过支付。
  • 为了避免用户支付完成后直接关闭页面、前端事件未触发的丢单问题,可以在Coinbase后台配置Webhook通知地址,当支付状态更新时,平台会主动将包含charge_id和最新状态的请求推送到你的后端接口,实现双保险的状态追踪。

内容的提问来源于stack exchange,提问作者Festus Chika

相关产品推荐
方舟 Agent Plan

超全模态模型 × Harness 升级,最新支持 Deepseek-V4.1-Flash、GLM-5.3 系列、Doubao-Seedream-5.0-pro、Kimi-K3 (部分), 限时 9.9 元起

最近更新时间:2026.11.09 12:06:01