← Servicios
Construir sobre · WooCommerce

WooCommerce lleva tu tienda. No tiene por qué llevar tu pago.

El catálogo, el stock, los cupones y el registro de pedidos ya están resueltos, y ya los estás pagando. Esta página es sobre la línea donde esa instalación se detiene, y qué se puede construir al otro lado sin reemplazar nada.

$ agendar --20min Agendar llamada → Verificado contra la documentación oficial de WooCommerce el 21 de noviembre de 2026.
Lo que ya resuelve

Esto ya existe y se consulta por API. No lo cotices.

La mitad de lo que una tienda le pide a un desarrollador ya está en WooCommerce y se puede leer desde afuera. Preferimos decirlo acá antes que ponerlo en una propuesta.

  • El catálogo completo, con atributos, categorías, marcas, etiquetas y reseñas, cada uno con su propia ruta de lectura.
  • El carrito entero: agregar, quitar, cambiar cantidades, aplicar y sacar cupones, y elegir la tarifa de envío.
  • El cálculo de totales, impuestos y envío, que es justo la parte que nadie debería reimplementar.
  • El pedido en borrador antes de pagar, y el pedido confirmado después, con su registro en el panel de WordPress de siempre.
  • La sesión del visitante, por cookies, para que el carrito siga ahí cuando vuelva.

Todo lo de arriba son rutas documentadas de la Store API. Que exista no significa que se vea bien: significa que el trabajo está en la pantalla, no en la lógica.

Dónde se detiene

Cuatro lugares donde la tienda no se dobla.

Todo sistema tiene un borde. Estos cuatro conviene conocerlos antes de planificar nada, porque son los que deciden la arquitectura y los que ve tu clienta.

Tope 1 La Store API no escribe la tienda Su documentación lo dice sin rodeos: «no se puede usar para escribir datos de la tienda, por ejemplo la configuración». Sirve para vender, no para administrar. Cualquier cosa que toque productos, precios o pedidos desde afuera necesita la otra API, la autenticada.
Tope 2 Solo ve al visitante de ahora La misma página dice que «no se puede usar para consultar otros clientes y pedidos por identificador, solo los datos del usuario actual». Por eso un portal con historial no se construye con ella, y por eso las llamadas del portal van desde el servidor: la clave de la REST API es, literalmente, el usuario de una autenticación básica. En el navegador queda a la vista de cualquiera.
Tope 3 El pago vuelve, y ahí se pierden los pedidos El endpoint de pago «intenta el pago y devuelve el resultado», con una dirección a la que mandar al cliente. El problema no es el pago: es el regreso. Si el cliente cierra el navegador entre la pasarela y tu sitio, el cobro quedó hecho y la tienda no se enteró. En la certificación de Webpay Plus que hicimos, medimos que un pago autorizado sin confirmar lo anula Transbank entre 30 y 65 segundos después del retorno. Ese es el tamaño real de la ventana.
Tope 4 El pago que viene incluido pide todo de una vez En la tienda que medimos, el formulario de pago mostraba más de quince campos al mismo tiempo, sin indicador de avance y sin pedir el correo al principio, que es lo único que permite recuperar una compra abandonada. Con más del ochenta por ciento del tráfico en teléfono, eso no es un detalle de diseño.
Las dos API

Cuál usar, y por qué no da lo mismo.

Elegir mal acá no se nota el primer día. Se nota cuando hay que mostrar el historial de una clienta, o cuando alguien abre el código del sitio en el navegador.

Store API La que puede hablar desde el navegador Ruta /wp-json/wc/store/v1. Su documentación dice que es una API sin autenticación, que no pide claves ni tokens de acceso. Lo que escribe pide un nonce, y el pago acepta además un Cart-Token. Solo ve los datos del visitante actual, que es justamente lo que la hace segura de usar desde el sitio. Para el catálogo, el carrito y el pago, es esta.
REST API La que se queda en el servidor Ruta /wp-json/wc/v3. Se autentica con una clave y un secreto generados en el panel, y sobre HTTPS van como usuario y contraseña de una autenticación básica. Da acceso completo, así que nunca sale del servidor. Para el portal, el panel y cualquier sincronización, es esta. Un detalle que cuesta una tarde: su documentación advierte que los enlaces permanentes por defecto de WordPress no funcionan.

La regla práctica, y la que aplicamos: el sitio conversa con la Store API desde el navegador; el portal, el panel y las sincronizaciones conversan con la REST API desde el servidor. Una clave de WooCommerce en el código del navegador entrega la tienda completa.

Lo que se construye encima

Seis cosas, y la tienda se queda donde está.

01
Carrito y pago en tu propio sitio

Mismo dominio, mismo diseño, sin el salto a WordPress a medio camino. El pedido llega igual a WooCommerce y la pasarela sigue siendo el salto a su dominio seguro, que es como funcionan todas.

store api · nonce · cart-token
02
El regreso del pago, bien resuelto

Confirmación inmediata al volver, reintento si el primero falla, un solo cobro aunque el cliente recargue cinco veces, y una conciliación que revisa después los pagos autorizados que nadie confirmó.

idempotencia · conciliación
03
Un portal con tu marca

Historial, documentos, estados y pedidos, en tu dominio y con tu diseño. Contra la REST API y desde el servidor, porque es la única forma de mostrarle a cada cliente lo suyo sin exponer el resto.

rest api · servidor · sesión
04
Un panel con tus números

Armado alrededor de lo que revisas un lunes, no alrededor de cada campo que WooCommerce guarda. En solo lectura, así nada se puede romper desde ahí.

lectura · gráficos
05
Los datos que la tienda no guarda

El campo que no existe, tu propio estado de un pedido, la observación que hoy vive en una planilla. En una base propia con su mantenedor, y mostrado junto al dato de WooCommerce como si fuera uno solo.

postgres · mantenedores
06
Avisos donde ya trabajas

Un pedido grande, un stock en cero, un pago que quedó a medias. Al correo, a Slack, a Telegram o a WhatsApp, en el momento, sin que nadie tenga que abrir el panel para enterarse.

webhooks · avisos
De dónde sale esto

Una tienda chilena que ya corre así.

No es una propuesta teórica. La tienda de D’SKIN es Astro por delante y WooCommerce por detrás, y desde febrero de 2026 el pago ocurre en el propio sitio, con WooCommerce como catálogo y registro de pedidos.

Medido en producción con Lighthouse móvil, mediana de tres corridas: rendimiento 99, accesibilidad 100, SEO 100, LCP 1,3 segundos. El caso completo, con lo que se rompió en el camino, está en la ficha del proyecto. Lo de la pasarela viene de la certificación de Webpay Plus de esa misma tienda: seis casos obligatorios aprobados, más las pruebas de abandono, de doble retorno y de seis retornos simultáneos.

Preguntas frecuentes
¿WooCommerce tiene API?

Tiene dos, y sirven para cosas distintas. La Store API vive en /wp-json/wc/store/v1 y su documentación dice que es «una API sin autenticación» que no pide claves: es la que usa el sitio para el catálogo, el carrito y el pago. La REST API vive en /wp-json/wc/v3, se autentica con una clave y un secreto que se generan en el panel de WordPress, y es la que da acceso completo a pedidos y clientes.

¿Se puede tener el pago en mi propio sitio y no en WordPress?

Sí, y es lo más común que nos piden. El carrito y el pago se construyen en tu sitio contra la Store API, y WooCommerce queda como catálogo y registro de pedidos. La pasarela sigue siendo un salto a su dominio seguro, que es como funcionan todas. En la tienda de D’SKIN el pago ocurre en el propio sitio desde febrero de 2026.

¿Puedo mostrarle a cada cliente su historial de pedidos?

Sí, pero no con la Store API. Su documentación es explícita: «no se puede usar para consultar otros clientes y pedidos por identificador», solo los datos del visitante actual. Un portal con historial se construye contra la REST API autenticada, y esas llamadas van siempre desde el servidor, nunca desde el navegador.

¿Hay que migrar la tienda para hacer esto?

No, y es el punto. WooCommerce se queda donde está, con sus productos, sus pedidos y sus plugins. Lo que se construye vive al lado y conversa por API. Si algún día la tienda sí tiene que cambiar de plataforma, se cambia con el sitio ya construido encima, que es bastante menos riesgoso que hacerlo todo de golpe.

¿Qué pasa si el cliente cierra el navegador después de pagar?

Eso es exactamente lo que hay que resolver antes de salir a producción, y es donde se pierden los pedidos. El pago queda autorizado en la pasarela y la tienda no se enteró. La respuesta no es confiar en el retorno: es confirmar en el momento en que llega y, además, dejar una conciliación que revise después los pagos autorizados sin confirmar.

Trae tu tienda, y lo que no te deja hacer.

Veinte minutos suelen bastar para saber si es un desarrollo, un plugin que ya existe, o algo que mejor no hagas.