Guardar campos de pago personalizados usando wooCommerce_checkout_update_order_meta

Publicado: 2025-07-01

Personalizar su pago de WooCommerce es una necesidad común, especialmente cuando desea recopilar detalles adicionales de sus clientes. Ya sea que se trate de una nota especial o una entrada personalizada como una instrucción de entrega, WooCommerce permite guardar estos campos en el pedido. En esta guía, aprenderá cómo agregar dos campos nuevos y almacenar sus valores utilizando la acción woocommerce_checkout_update_order_meta . Además, mostraremos cómo un complemento como Flexible Chickout Fields Pro puede hacer que todo sea más fácil.

Caminemos paso a paso cómo almacenar el meta de pedido personalizado en WooCommerce.

¿Qué es la personalización del pago en WooCommerce y cómo se procesan los datos del pedido?

El proceso de pago de WooCommerce implica varios pasos clave. Cuando un cliente llena el formulario y golpea el 'pedido de lugar', WooCommerce valida los datos, almacena información de facturación/envío y dispara ganchos que los desarrolladores pueden usar para almacenar datos adicionales.

Por defecto, solo se guardan los campos estándar como el nombre, el correo electrónico y la dirección.

Pero puede extender esto utilizando el filtro woocommerce_checkout_fields para agregar campos personalizados al formulario.

Luego, con la acción woocommerce_checkout_update_order_meta , puede guardar sus valores como meta de orden .

Esto es particularmente útil cuando desea incluir cosas como mensajes de regalo, preferencias de entrega o instrucciones personalizadas.

Incluso puede mostrar estos datos más adelante en el panel de administración, los correos electrónicos o las páginas de agradecimiento.

¿Cómo agregar y guardar campos personalizados usando código en WooCommerce?

Digamos que desea recopilar dos piezas de información adicional:

  • Una entrada de texto personalizada ("texto personalizado")
  • Un mensaje TextAREA ("Mensaje personalizado")

Aquí le mostramos cómo hacerlo.

El siguiente código con woocommerce_checkout_fields y woocommerce_checkout_update_order_meta se deben agregar a las funciones del tema.php para mostrar nuevos campos de pago y guardar los datos como meta de orden.

1. Agregue los campos personalizados al formulario de pago

 add_filter('woocommerce_checkout_fields', 'add_custom_checkout_fields'); function add_custom_checkout_fields($fields) { $fields['billing']['custom_text_field'] = array( 'type' => 'text', 'label' => __('Custom Text', 'woocommerce'), 'required' => false, 'priority' => 110, ); $fields['billing']['custom_message_field'] = array( 'type' => 'textarea', 'label' => __('Custom Message', 'woocommerce'), 'required' => false, 'priority' => 120, ); return $fields; }
Agregar campos personalizados al ejemplo de formulario de pago de WooCommerce
Agregar campos personalizados al ejemplo de formulario de pago de WooCommerce

2. Guarde los valores de campo en el meta

 add_action('woocommerce_checkout_update_order_meta', 'save_custom_checkout_fields'); function save_custom_checkout_fields($order_id) { if (!empty($_POST['custom_text_field'])) { update_post_meta($order_id, '_custom_text_field', sanitize_text_field($_POST['custom_text_field'])); } if (!empty($_POST['custom_message_field'])) { update_post_meta($order_id, '_custom_message_field', sanitize_textarea_field($_POST['custom_message_field'])); } }

Ahora, ambos campos aparecerán en el panel de administración bajo los campos personalizados de la orden.

Texto personalizado y ejemplo de textura en los detalles del pedido
Texto personalizado y ejemplo de textura en los detalles del pedido
También puede personalizar el código para validar los datos o permitir su edición con woocommerce_wp_text_input y woocommerce_wp_textarea_input Funciones en los detalles del orden dentro del DIV con class = "edit_address", por lo que está oculto antes de editar.

Este enfoque funciona bien, pero requiere algún conocimiento de codificación.

También tiene limitaciones cuando se trata de validación, tipos de campo o visualización de datos condicionalmente.

Ahí es donde entran los campos de pago flexibles.

¿Por qué utilizar los campos de pago flexibles Pro en lugar de escribir código personalizado?

Si bien codificar sus propios campos y guardarlos con la acción woocommerce_checkout_update_order_meta le brinda control total, no siempre es la solución más eficiente o segura, especialmente para los no desarrolladores.

Ahí es donde el complemento flexible de campos de pago se convierte en una opción más fácil y rápida.

Agregar campos personalizados al formulario de pago de WooCommerce con un ejemplo de campos de pago flexibles
Agregar campos personalizados al formulario de pago de WooCommerce con un ejemplo de campos de pago flexibles
Hay una versión gratuita disponible en WordPress.org: Campos de pago flexibles - GRATIS, que es perfecto para la gestión básica de campo. Sin embargo, la versión Pro le brinda mucha más flexibilidad.
Campos de visualización en páginas específicas: configuración de complementos en campos de pago flexibles WooCommerce
Campos de visualización en páginas específicas: configuración de complementos en campos de pago flexibles WooCommerce

Aquí hay 5 características sobresalientes que hacen que valga la pena usar los campos de pago flexibles :

  • Manager de campo de arrastrar y soltar : no es necesario escribir funciones PHP. Simplemente arrastre y reordene los campos directamente en el administrador de WordPress.
  • Variedad de tipos de campo : agregue texto, textura, selección, radio, casilla de verificación, selección de fecha, hora y más.
  • Reglas de visualización : muestre u oculte campos basados ​​en el método de envío/pago seleccionado o las condiciones del carrito.
    Condiciones para campos de formularios personalizados en campos de pago flexibles pro wooCommerce
    Condiciones para campos de formularios personalizados en campos de pago flexibles pro wooCommerce
  • Validación predefinida : establezca fácilmente los campos requeridos y use opciones de validación incorporadas sin funciones personalizadas.
  • Precios : precio adicional por campos de pago.
    Ejemplo de campo de precios adicionales por formulario en campos de pago flexibles pro wooCommerce
    Ejemplo de campo de precios adicionales por formulario en campos de pago flexibles pro wooCommerce

En lugar de registrar manualmente campos y guardar meta datos con woocommerce_checkout_update_order_meta , obtiene una interfaz completa.

Además, todos los valores de campo guardados aparecen perfectamente en el resumen del pedido y los correos electrónicos.

Si está buscando una solución escalable a largo plazo para manejar los campos de pago personalizados y guardar datos para ordenar meta , este complemento ahorra horas de codificación y mantenimiento.

Campos de pago flexibles pro wooCommerce £ 59

Editar, agregar nuevos o ocultar campos innecesarios del formulario de pago de WooCommerce. Agregue el precio a los campos y use la lógica condicional. Se trata de conversiones y una mejor experiencia de usuario. NUEVO: Ahora puede establecer múltiples condiciones (o) en uno o más grupos de condición (y).

Instalaciones activas: 90,000+ | Calificación de WordPress:

Añadir a la cesta o ver detalles
Más de 90,000 instalaciones activas
Última actualización: 2025-06-23
Trabaja con WooCommerce 9.6 - 9.9

wooCommerce_checkout_update_order_meta vs Plugin: ¿Qué método debe elegir?

Si está creando una integración personalizada o tiene requisitos muy específicos, entonces woocommerce_checkout_update_order_meta combinado con woocommerce_checkout_fields es una forma poderosa y confiable de hacerlo.

Sin embargo, si desea una forma más fácil de personalizar su pago y evitar el código por completo, el complemento de campos de pago flexible es imprescindible.

Acelera su flujo de trabajo y elimina las conjeturas de la edición de su pago de WooCommerce.

Resumen

  • Use woocommerce_checkout_fields para agregar nuevos campos de pago.
  • Use woocommerce_checkout_update_order_meta para guardar esos campos para ordenar meta.
  • El código personalizado ofrece flexibilidad pero requiere soporte y pruebas continuas.
  • Flexible de pago Fields Pro le permite administrar campos visualmente con opciones avanzadas.
  • También hay una versión gratuita si solo necesita edición básica de campo.