Guardar campos de pago personalizados usando wooCommerce_checkout_update_order_meta
Publicado: 2025-07-01Personalizar 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.
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; }

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.

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.


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 - 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
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:
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.