Prestashop 1.7：切换支付方式时通过Ajax更新运费的实现方案

核心逻辑 #

用户切换货到付款（COD）支付方式时，前端触发Ajax请求，后端带上COD标识重新调用承运商API计算溢价运费，最终返回结果更新前端运费展示。

步骤1：前端监听支付方式切换 #

在模块的前端JS文件（或通过registerHook('displayFooter')注入脚本）中，监听支付选项变更事件，判断是否选中COD支付：

// 用事件委托监听动态渲染的支付选项
$(document).on('change', 'input[name="payment-option"]', function() {
    const selectedModule = $(this).closest('.payment-option').data('module-name');
    // 替换为你的COD支付模块名称，默认Prestashop自带COD模块名为cashondelivery
    const isCod = selectedModule === 'cashondelivery';
    const cartId = $('input[name="id_cart"]').val();

    // 触发运费更新请求
    refreshCarrierFees(isCod, cartId);
});

function refreshCarrierFees(isCod, cartId) {
    $.ajax({
        url: `${prestashop.urls.base_url}index.php?fc=module&module=你的模块名&controller=ajaxfees`,
        type: 'POST',
        data: {
            id_cart: cartId,
            is_cod: isCod ? 1 : 0,
            ajax: 1
        },
        dataType: 'json',
        success: function(res) {
            if (res.success && res.carriers) {
                // 逐个更新承运商的运费显示
                res.carriers.forEach(carrier => {
                    const $priceEl = $(`input[name="delivery_option"][value="${carrier.id}_${carrier.id}"]`)
                        .closest('.delivery-option')
                        .find('.price');
                    if ($priceEl.length) {
                        $priceEl.html(carrier.formatted_price);
                    }
                });
                // 同步更新订单总金额（复用Prestashop原生刷新逻辑）
                updateCartTotal();
            }
        }
    });
}

function updateCartTotal() {
    $.post(`${prestashop.urls.pages.cart}`, { ajax: 1, action: 'refresh' }, function(data) {
        $('#cart-summary-total').html(data.total);
        // 按需更新其他金额元素，如小计、税费等
    });
}

步骤2：后端创建Ajax处理控制器 #

在模块目录下新建controllers/front/ajaxfees.php，处理Ajax请求并重新计算运费：

<?php
class YourModuleNameAjaxfeesModuleFrontController extends ModuleFrontController
{
    public function initContent()
    {
        parent::initContent();
        if (!$this->ajax) die('Invalid request');

        $idCart = (int)Tools::getValue('id_cart');
        $isCod = (bool)Tools::getValue('is_cod');
        $cart = new Cart($idCart);

        // 验证购物车归属，防止恶意请求
        if (!$cart->id || $cart->id_customer != $this->context->customer->id) {
            die(json_encode(['success' => false, 'msg' => 'Invalid cart']));
        }

        // 调用模块自定义运费计算方法
        $updatedFees = $this->module->calcCarrierFeesWithCod($cart, $isCod);
        die(json_encode(['success' => true, 'carriers' => $updatedFees]));
    }
}

步骤3：修改模块运费计算逻辑 #

在模块主文件中，新增支持COD参数的运费计算方法，调用承运商API时传入COD相关标识：

public function calcCarrierFeesWithCod(Cart $cart, $isCod = false)
{
    $carriers = [];
    $cartWeight = $cart->getTotalWeight();
    $orderTotal = $cart->getOrderTotal(true, Cart::BOTH);

    // DHL运费计算
    $dhlParams = [
        'weight' => $cartWeight,
        'destination' => $this->context->country->iso_code,
        // 其他基础参数...
    ];
    if ($isCod) {
        // 按DHL API要求添加COD参数，示例：
        $dhlParams['cod_indicator'] = 'Y';
        $dhlParams['cod_amount'] = $orderTotal;
    }
    $dhlFee = $this->callDhlApi($dhlParams);
    $carriers[] = [
        'id' => 你的DHL承运商ID,
        'name' => 'DHL',
        'price' => $dhlFee,
        'formatted_price' => Tools::displayPrice($dhlFee, $this->context->currency)
    ];

    // FedEx运费计算
    $fedexParams = [
        'weight' => $cartWeight,
        'ship_to' => $this->context->country->iso_code,
        // 其他基础参数...
    ];
    if ($isCod) {
        // 按FedEx API要求添加COD参数，示例：
        $fedexParams['cod_detail'] = [
            'amount' => $orderTotal,
            'currency' => $this->context->currency->iso_code
        ];
    }
    $fedexFee = $this->callFedexApi($fedexParams);
    $carriers[] = [
        'id' => 你的FedEx承运商ID,
        'name' => 'FedEx',
        'price' => $fedexFee,
        'formatted_price' => Tools::displayPrice($fedexFee, $this->context->currency)
    ];

    return $carriers;
}

// 原有API调用方法保留，适配新增参数即可
private function callDhlApi($params)
{
    // 你的DHL API调用逻辑，返回最终运费金额
}

private function callFedexApi($params)
{
    // 你的FedEx API调用逻辑，返回最终运费金额
}

步骤4：权限与路由校验 #

• 确保模块已安装启用，且ajaxfees控制器命名符合Prestashop规范（模块名+控制器名，首字母大写）
• 测试时关闭模块缓存，避免旧逻辑干扰

关键注意事项 #

• 承运商API的COD参数需严格对应官方文档，不同服务商参数差异极大
• 后端需验证购物车所有权，防止非法请求篡改运费
• 若Prestashop启用了运费缓存，需在计算时通过自定义缓存键或随机参数跳过缓存

内容的提问来源于stack exchange，提问作者Dinesh.R