如何通过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
相关产品推荐
相关产品推荐

