如何在Opencart支付成功后立即触发请求至外部Web API

问题1答复 #

OpenCart官方应用市场和第三方开源社区均有成熟的订单Webhook推送类扩展，覆盖2.x、3.x、4.x主流版本，这类扩展默认支持的配置能力完全匹配你的基础需求：

• 支持自定义触发条件，可指定仅当订单状态变更为「支付成功」时触发推送
• 内置配置项支持填写目标API地址、接口密钥，支持自定义请求头参数
• 支持可视化勾选需要推送的订单字段，可直接匹配你侧.NET WebAPI的入参要求
  这类扩展大多已做了适配，合作伙伴只需在OpenCart后台上传安装包，完成配置即可使用，无需任何代码修改。

问题2答复 #

如果现有扩展的签名逻辑、字段格式无法匹配你侧API的特殊要求，你完全可以自行开发自定义扩展，开发成本极低：
OpenCart原生提供事件订阅机制，你只需绑定order.status.update系统事件，当订单状态变更为支付成功对应的状态ID时，自动触发你写的API调用逻辑即可。开发完成后可打包为对应版本的扩展安装包，合作伙伴后台一键上传即可安装，所有配置项都可以做在扩展的后台设置页，不会侵入OpenCart核心代码，不影响站点原有功能。

开发参考 #

你可以参考以下核心逻辑编写扩展：

// 订单状态变更事件回调
public function handleOrderPaid($order_id, $new_status_id) {
    // 从扩展配置读取预设的支付成功状态ID
    $target_status = $this->config->get('custom_api_pay_success_status');
    if ($new_status_id != $target_status) {
        return;
    }
    // 获取订单全量数据，可按需筛选字段
    $this->load->model('sale/order');
    $order_data = $this->model_sale_order->getOrder($order_id);
    // 读取配置的API信息
    $api_url = $this->config->get('custom_api_endpoint');
    $api_secret = $this->config->get('custom_api_secret');
    // 发起请求调用你侧.NET WebAPI
    $curl = curl_init($api_url);
    curl_setopt_array($curl, [
        CURLOPT_RETURNTRANSFER => true,
        CURLOPT_POST => true,
        CURLOPT_POSTFIELDS => json_encode($order_data),
        CURLOPT_HTTPHEADER => [
            'Content-Type: application/json',
            'X-Request-Sign: ' . hash('sha256', json_encode($order_data) . $api_secret)
        ]
    ]);
    $response = curl_exec($curl);
    curl_close($curl);
}

开发前先确认合作伙伴的OpenCart具体版本，不同版本的扩展打包、事件注册的语法有细微差异，按照对应版本的开发规范实现即可。

内容的提问来源于stack exchange，提问作者Amit Ranjan