actionValidateOrder

#Descripcion

Se ejecuta cuando un pedido es completamente validado, es decir, despues de que el modulo de pago llame a `validateOrder()`. Es el hook mas importante del ciclo de vida de un pedido. Se dispara una sola vez por pedido, justo cuando el dinero es confirmado y el pedido queda registrado en la base de datos.

#Parametros

#Ejemplo de codigo

<?php
// En el metodo install() de tu modulo:
public function install()
{
    return parent::install()
        && $this->registerHook('actionValidateOrder');
}

<?php
/**
 * Hook actionValidateOrder
 * Se ejecuta cuando el pedido es confirmado
 */
public function hookActionValidateOrder(array $params)
{
    /** @var Order $order */
    $order    = $params['order'];
    /** @var Cart $cart */
    $cart     = $params['cart'];
    /** @var Customer $customer */
    $customer = $params['customer'];
    /** @var Currency $currency */
    $currency = $params['currency'];

    // Ejemplo: Enviar notificacion a sistema externo
    $data = [
        'order_id'    => $order->id,
        'reference'   => $order->reference,
        'total'       => $order->total_paid,
        'currency'    => $currency->iso_code,
        'customer'    => $customer->email,
        'date'        => date('Y-m-d H:i:s'),
    ];

    // Registrar en la BD del modulo
    Db::getInstance()->insert('my_order_export', [
        'id_order'   => (int)$order->id,
        'data'       => pSQL(json_encode($data)),
        'created_at' => date('Y-m-d H:i:s'),
    ]);

    // Enviar webhook
    // $this->sendWebhook($data);
}

#Notas y gotchas

• ⚠️ Este hook se ejecuta **una sola vez** por pedido, cuando el pago es confirmado.
• ⚠️ El parametro `$params['order']` ya tiene `id > 0` — el pedido ya esta en la BD.
• ⚠️ Si necesitas ejecutar logica despues de que el estado del pedido sea asignado, usa `actionOrderStatusUpdate`.
• ⚠️ Evita operaciones pesadas o peticiones HTTP sincronas en este hook — pueden bloquear al cliente en la pagina de confirmacion.
• ⚠️ El carrito (`$params['cart']`) ya NO esta activo en este punto — ha sido 'consumido' para crear el pedido.
• ⚠️ Para crear facturas o documentos PDF despues del pedido, usa `actionSetInvoice` en su lugar.

#Relacionados

#Historial de versiones