咨询Prestashop后台（部分）退款钩子，actionOrderReturn无效

嘿，我来帮你梳理下PrestaShop后台和部分退款相关的钩子问题～

首先得明确：actionOrderReturn 钩子其实是针对订单退货（商品退回）流程的，不是直接对应退款操作的，所以你用它来监听退款（尤其是部分退款）肯定不会触发，这就是它没正常工作的原因啦。

下面是几个真正适配退款（包括部分退款）的核心钩子：

1. actionRefundPost #

这个钩子是在退款操作完成后触发的，不管是全额还是部分退款都会被触发。它能拿到退款的关键数据，比如退款金额、关联的订单对象、退款对应的支付记录等。

举个简单的使用示例：

public function hookActionRefundPost($params)
{
    // 获取退款相关参数
    $refund_amount = $params['amount'];
    $order = $params['order'];
    $payment = $params['payment'];
    
    // 在这里添加你的自定义逻辑，比如记录退款日志、触发通知等
    if ($refund_amount < $order->total_paid) {
        // 这是部分退款的情况
        $this->context->controller->log->addLog("订单 {$order->reference} 完成部分退款，金额：{$refund_amount}", 1);
    }
}

2. actionUpdateOrderPayment #

当订单的支付记录被更新时（包括退款操作导致的支付记录修改），这个钩子会触发。它适合在退款状态变更时做一些同步操作，比如更新第三方系统的支付状态。

示例代码：

public function hookActionUpdateOrderPayment($params)
{
    $order_payment = $params['orderPayment'];
    $order = $order_payment->getOrder();
    
    // 检查是否是退款操作（order_payment的amount为负数表示退款）
    if ($order_payment->amount < 0) {
        $refund_amount = abs($order_payment->amount);
        // 处理部分退款逻辑
        $this->sendRefundNotification($order, $refund_amount);
    }
}

3. actionOrderStatusPostUpdate #

如果你的部分退款操作会伴随订单状态变更（比如从"已付款"变为"部分退款"），这个钩子可以在状态更新后触发，你可以在这里结合订单状态和金额判断是否是部分退款场景。

额外注意事项 #

• 不同PrestaShop版本的钩子可能有细微差异，比如1.7.x和8.x的参数结构，建议你结合对应版本的官方文档确认参数细节。
• 如果你是在开发模块，记得在模块的install()方法里注册这些钩子，比如：

public function install()
{
    return parent::install() &&
        $this->registerHook('actionRefundPost') &&
        $this->registerHook('actionUpdateOrderPayment');
}

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