Ganchos y filtros

Los desarrolladores pueden ampliar y personalizar la puerta de enlace PowerTranz utilizando ganchos y filtros de WordPress. Esta referencia documenta los puntos de extensión disponibles.

Ganchos de acción

woocommerce_recibo_powertranz

Se activa en la página de recepción de pedidos para los pagos con PowerTranz. Se utiliza internamente para mostrar formularios de redireccionamiento 3D Secure cuando es necesario.

add_action( 'woocommerce_receipt_powertranz', 'my_receipt_function' );

  function my_receipt_function( $order_id ) {
      // Custom receipt page content
  }

woocommerce_api_powertranz_3ds_return

Gestiona la URL de devolución de llamada cuando un cliente regresa de la autenticación 3D Secure. El complemento la utiliza internamente.

woocommerce_api_powertranz_webhook

Gestiona las notificaciones entrantes de webhooks de PowerTranz. Se utiliza internamente para confirmaciones de pago asincrónicas.

woocommerce_scheduled_subscription_payment_powertranz

Se activa cuando vence el pago de la renovación de una suscripción. El complemento lo utiliza para procesar pagos recurrentes automáticos.

add_action( 'woocommerce_scheduled_subscription_payment_powertranz', 'my_renewal_function', 10, 2 );

  function my_renewal_function( $renewal_total, $renewal_order ) {
      // Custom logic before/after renewal processing
  }

Ganchos de filtro

icono de pasarela de pago de WooCommerce

Filtra el ícono de la pasarela de pago que se muestra al finalizar la compra.

add_filter( 'woocommerce_gateway_icon', 'customize_powertranz_icon', 10, 2 );

  function customize_powertranz_icon( $icon, $gateway_id ) {
      if ( 'powertranz' === $gateway_id ) {
          // Return custom icon HTML
          $icon = '<img src="your-custom-icon.png" alt="Pay with Card" />';
      }
      return $icon;
  }

Acciones de pedido de WooCommerce

El complemento añade acciones de pedido personalizadas para capturar y anular pagos autorizados. Puede filtrar estas acciones si es necesario.

add_filter( 'woocommerce_order_actions', 'modify_powertranz_actions' );

  function modify_powertranz_actions( $actions ) {
      // Modify available order actions
      return $actions;
  }

woocommerce_métodos_de_pago_elemento_de_la_lista

Filtra la visualización de los métodos de pago guardados en el área Mi cuenta del cliente.

Constantes

Las siguientes constantes están disponibles después de que se carga el complemento:

Constante	Descripción	Valor de ejemplo
POWERTRANZ_VERSION	Versión actual del complemento	‘1.0.6’
POWERTRANZ_PLUGIN_FILE	Ruta absoluta al archivo principal del complemento	/var/www/wp-content/plugins/powertranz…/powertranz-gateway.php
POWERTRANZ_PLUGIN_DIR	Ruta absoluta al directorio de complementos	/var/www/wp-content/plugins/powertranz…/
POWERTRANZ_PLUGIN_URL	URL del directorio de complementos	https://example.com/wp-content/plugins/powertranz…/
POWERTRANZ_PLUGIN_BASENAME	Nombre base del plugin para hooks	powertranz-woocommerce-gateway/powertranz-gateway.php

Uso de constantes

// Check plugin version
  if ( defined( 'POWERTRANZ_VERSION' ) ) {
      echo 'PowerTranz version: ' . POWERTRANZ_VERSION;
  }

  // Include a file from the plugin directory
  include POWERTRANZ_PLUGIN_DIR . 'includes/my-custom-file.php';

  // Enqueue a script from the plugin
  wp_enqueue_script( 'my-script', POWERTRANZ_PLUGIN_URL . 'assets/js/custom.js' );

API de pasarela de pago de WooCommerce

La puerta de enlace PowerTranz amplía la WC_Payment_Gateway clase. Para personalizaciones avanzadas, consulte la documentación de la API de la pasarela de pago de WooCommerce.

Patrones de extensión comunes:

• Uso woocommerce_payment_complete acción para el procesamiento posterior al pago
• Uso woocommerce_order_status_changed reaccionar ante los cambios en el estado de los pedidos
• Uso woocommerce_available_payment_gateways para mostrar/ocultar la puerta de enlace de forma condicional