Descripción
Socialhero Promotions conecta tu tienda WooCommerce con Socialhero. En el carrito y en la página de pago aparece un widget donde el cliente elige una de dos opciones (ninguna viene marcada):
- Pagar y obtener beneficios Socialhero: paga con su Tarjeta de Pago o de Regalo con Sentido. La tarjeta se valida y su titular autoriza el cobro desde la app Tarjetas con Sentido o desde el enlace que le llega por correo o SMS. Mientras espera, el cliente ve el tiempo que queda y lo que cubrirá la tarjeta. Una vez autorizada, el saldo queda apartado y se descuenta sólo cuando se confirma el pago del pedido; lo que no cubra la tarjeta se paga con los medios de pago de la tienda.
- Obtener beneficios Socialhero: escribe su número de cuenta Socialhero y se aplican las promociones de los productos del carrito: los Tokens Sociales que recibirá y, si tiene Tokens Premio, el descuento que puede aplicar autorizándolo con la contraseña de su cuenta.
Además:
- Si la tarjeta pertenece a una cuenta de la app con varias tarjetas, el cobro se reparte entre ellas y el cliente puede ver el detalle por tarjeta.
- Los reembolsos y cancelaciones de WooCommerce regresan el saldo a las tarjetas y revierten los Tokens Premio y Tokens Sociales de la compra, en proporción a lo devuelto.
- En el pedido, en los correos y en el administrador se muestra lo que se pagó con cada tarjeta.
- El administrador incluye un reporte de pagos con tarjetas Socialhero que se puede exportar a CSV.
- En la tienda y en las categorías se muestra una nota que indica que el pago con tarjetas se hace desde el carrito.
- Un botón «Comprar ahora» lleva un producto directo a la página de pago.
Para usar el plugin tu comercio necesita una cuenta de Socialhero con el servicio de tarjetas y/o promociones activo.
Importante: el plugin viene en modo Sandbox (pruebas). Para vender hay que cambiarlo a Producción y capturar las credenciales de API de producción. Solicita tus credenciales a tu contacto Socialhero.
External services
Este plugin se conecta a servicios de Socialhero (Socialhero, México) para funcionar. Sin ellos no puede validar tarjetas ni promociones.
API de Socialhero (https://api.socialhero.com.mx)
- Se usa para validar el número de cuenta Socialhero y las promociones del carrito; validar, reservar, cobrar, cancelar y reembolsar los pagos con Tarjetas de Pago o de Regalo con Sentido; autorizar la redención de Tokens Premio; confirmar, cancelar o reembolsar las ventas; y registrar los webhooks de la tienda.
- Se envía cuando el cliente valida su número de cuenta o su tarjeta, cuando autoriza Tokens Premio, cuando se paga, cancela o reembolsa un pedido que usó Socialhero, y cuando el administrador guarda la configuración del plugin.
- Datos que se envían: el número de cuenta Socialhero o el código de la tarjeta; la contraseña de la cuenta Socialhero sólo al autorizar Tokens Premio (no se guarda en la tienda); los productos del carrito (código, cantidad y precio) y los totales; la referencia del pedido y los montos de reembolso; las credenciales de la API y la sucursal del comercio; y la dirección del sitio para los webhooks.
Imágenes de Socialhero (https://socialhero.com.mx)
- El widget muestra los íconos de los Tokens Sociales y Premio desde el sitio de Socialhero. El navegador del cliente los descarga al ver el resumen de la tarjeta; no se envían datos de la compra.
Términos y condiciones: https://www.socialhero.com.mx/terminos-condiciones
Aviso de privacidad: https://www.socialhero.com.mx/politicas-privacidad
Capturas
Bloques
Este plugin proporciona 2 bloques.
- Socialhero Promotions
- Socialhero Gift Card Payment
Instalación
- Instala y activa WooCommerce.
- Instala y activa Socialhero Promotions.
- Solicita a tu contacto Socialhero tus credenciales de API (usuario y contraseña) de producción.
- En el menú Socialhero Promotions del administrador, en Ambiente de API, elige Producción y guarda. El plugin viene en Sandbox (pruebas): mientras siga así, las tarjetas y los beneficios no son reales.
- En la misma pantalla, usa Agregar credenciales (o Actualizar credenciales) para capturar las credenciales de producción y elige tu Sucursal.
- El widget aparece solo en el carrito y en la barra lateral de la página de pago. Si prefieres otra ubicación, usa los bloques «Promociones Socialhero» y «Tarjeta Socialhero (aviso de pago)» en el editor de bloques.
Preguntas frecuentes
-
¿El plugin ya viene listo para vender?
-
No. Viene en modo Sandbox (pruebas), que se conecta al ambiente de pruebas de Socialhero. Para vender, en Socialhero Promotions Ambiente de API elige Producción, guarda y captura tus credenciales de API de producción. Si no las tienes, solicítalas a tu contacto Socialhero. Mientras falte algo, el administrador muestra un aviso.
-
Actualicé desde la versión 1.0.x y el widget no funciona
-
Las versiones 1.0.x usaban una credencial compartida que esta versión ya no usa. Cada tienda necesita sus propias credenciales de API: solicítalas a tu contacto Socialhero y captúralas en Socialhero Promotions. Si tu tienda estaba en modo «Live», el plugin la pasa a Producción automáticamente.
-
¿Cuándo se cobra la tarjeta?
-
Sólo cuando se confirma el pago del pedido. Mientras tanto, el saldo queda apartado hasta 15 minutos. Si el cliente no paga a tiempo o cancela, la tarjeta se libera sin cobrar nada.
-
¿Puedo desactivar el botón «Comprar ahora»?
-
Sí. Agrega esto a tu tema o a un plugin de personalizaciones:
add_filter( 'socialhero_enable_buy_now_button', '__return_false' );
Reseñas
No hay reseñas para este plugin.
Colaboradores y desarrolladores
«Socialhero Promotions» es un software de código abierto. Las siguientes personas han colaborado con este plugin.
Colaboradores
«Socialhero Promotions» ha sido traducido a 2 idiomas locales. Gracias a los traductores por sus contribuciones.
Traduce «Socialhero Promotions» a tu idioma.
¿Interesado en el desarrollo?
Revisa el código , echa un vistazo al repositorio SVN o suscríbete al registro de desarrollo por RSS.
Registro de cambios
Cambios de las versiones recientes. Ver changelog.txt para el historial completo.
2.1.35 – 2026-10-05
- Aviso en el administrador mientras el plugin esté en Sandbox (pruebas) o le falten las credenciales de API, con la indicación de solicitarlas a tu contacto Socialhero.
- La pantalla de configuración explica que el plugin viene en Sandbox y cómo pasarlo a Producción.
- Las tiendas que actualizan desde 1.0.x conservan su modo: «Live» pasa a Producción y «Test» a Sandbox.
- Se quitó de la configuración un aviso viejo que decía que la redención de tarjetas estaba deshabilitada.
2.1.34 – 2026-10-03
- El widget de beneficios del carrito y del checkout ahora tiene el mismo diseño, textos y pasos que el de Shopify: botón morado «Pagar y obtener beneficios Socialhero», opciones con logos, campos y botones iguales, mensajes, resumen de lo que cubre la tarjeta y ventanas (modales).
- La tarjeta va en 2 pasos, como en Shopify: «Validar tarjeta» (sólo revisa la tarjeta) y después «Continuar» / «Solicitar aprobación de redención» (manda la solicitud al titular).
- Mientras el titular decide, una ventana muestra el tiempo que queda y permite cancelar la solicitud.
- El botón del carrito para ir a pagar dice «Continuar con el pago» cuando la tarjeta ya está en «Compra por confirmar», y «Pagar por otros medios» en todos los demás casos.
- El botón para quitar el beneficio aplicado ahora dice «Cancelar».
- Ninguna opción viene elegida al abrir el carrito o la página de pago.
- El botón del número de afiliado dice «Validar cuenta Socialhero».
- Al confirmar los ajustes de una tarjeta, la ventana muestra que se está enviando la solicitud al titular.
- Las ventanas del widget quedan por encima del botón de PayPal exprés.
- En la tienda y las categorías aparece la nota «Para Pagos con Tarjeta de Pago/Regalo con Sentido, hacer compra a través del Carrito.»
- En el carrito clásico el widget se muestra junto a los totales.
- Se corrigieron acentos que salían mal en algunos mensajes de la autorización de Tokens Premio.
- Al cancelar una solicitud de tarjeta, ya no vuelve a aparecer la ventana de espera ni el aviso de vencimiento; y si la cancelación tarda en responder pero sí se hizo, ya no se marca la tarjeta como problema.