{"id":165045,"date":"2022-12-26T06:26:04","date_gmt":"2022-12-26T06:26:04","guid":{"rendered":"https:\/\/wordpress.org\/plugins\/socialhero-promotions\/"},"modified":"2026-10-05T18:37:11","modified_gmt":"2026-10-05T18:37:11","slug":"socialhero-promotions","status":"publish","type":"plugin","link":"https:\/\/ewe.wordpress.org\/plugins\/socialhero-promotions\/","author":23565749,"comment_status":"closed","ping_status":"closed","template":"","meta":{"version":"2.1.35","stable_tag":"2.1.35","tested":"7.1.3","requires":"5.8","requires_php":"7.2","requires_plugins":null,"header_name":"Socialhero Promotions","header_author":"Socialhero","header_description":"Allow your customers to shop while helping a good cause","assets_banners_color":"ffffff","last_updated":"2026-10-05 18:37:11","external_support_url":"","external_repository_url":"","donate_link":"","header_plugin_uri":"https:\/\/wordpress.org\/plugins\/socialhero-promotions\/","header_author_uri":"https:\/\/www.socialhero.com.mx","rating":0,"author_block_rating":0,"active_installs":0,"downloads":2356,"num_ratings":0,"support_threads":0,"support_threads_resolved":0,"author_block_count":0,"sections":["description","installation","faq","changelog"],"tags":{"1.0.1":{"tag":"1.0.1","author":"proficientdev","date":"2023-03-01 06:54:36","revision":2872839},"1.0.2":{"tag":"1.0.2","author":"proficientdev","date":"2023-04-24 05:24:24","revision":2903094},"1.0.4":{"tag":"1.0.4","author":"proficientdev","date":"2023-05-23 05:23:59","revision":2916152},"2.1.34":{"tag":"2.1.34","author":"juanpablosh","date":"2026-10-05 17:48:39","revision":3729393},"2.1.35":{"tag":"2.1.35","author":"juanpablosh","date":"2026-10-05 18:37:11","revision":3729490}},"upgrade_notice":{"2.1.35":"<p>Si vienes de la versi\u00f3n 1.0.x, captura tus propias credenciales de API (solic\u00edtalas a tu contacto Socialhero) y revisa que el Ambiente de API est\u00e9 en Producci\u00f3n.<\/p>"},"ratings":[],"assets_icons":{"icon-128x128.png":{"filename":"icon-128x128.png","revision":3729393,"resolution":"128x128","location":"assets","locale":"","width":128,"height":128},"icon-256x256.png":{"filename":"icon-256x256.png","revision":3729393,"resolution":"256x256","location":"assets","locale":"","width":256,"height":256}},"assets_banners":{"banner-1544x500.png":{"filename":"banner-1544x500.png","revision":3729393,"resolution":"1544x500","location":"assets","locale":"","width":1544,"height":500},"banner-772x250.png":{"filename":"banner-772x250.png","revision":3729393,"resolution":"772x250","location":"assets","locale":"","width":772,"height":250}},"assets_blueprints":{},"all_blocks":{"socialhero\/promotions":{"name":"socialhero\/promotions","title":"Socialhero Promotions"},"socialhero\/gift-card-payment":{"name":"socialhero\/gift-card-payment","title":"Socialhero Gift Card Payment"}},"tagged_versions":["1.0.1","1.0.2","1.0.4","2.1.34","2.1.35"],"block_files":[],"assets_screenshots":{"screenshot-1.png":{"filename":"screenshot-1.png","revision":3729393,"resolution":"1","location":"assets","locale":"","width":740,"height":1472},"screenshot-2.png":{"filename":"screenshot-2.png","revision":3729393,"resolution":"2","location":"assets","locale":"","width":660,"height":1137},"screenshot-3.png":{"filename":"screenshot-3.png","revision":3729393,"resolution":"3","location":"assets","locale":"","width":660,"height":1080},"screenshot-4.png":{"filename":"screenshot-4.png","revision":3729393,"resolution":"4","location":"assets","locale":"","width":740,"height":1598}},"screenshots":{"1":"Carrito: el cliente elige pagar con su Tarjeta de Pago o Regalo con Sentido, o s\u00f3lo obtener los beneficios con su n\u00famero de afiliado.","2":"Esperando la autorizaci\u00f3n del titular: tiempo restante, lo que cubre la tarjeta, Tokens Sociales a recibir y Tokens Premio.","3":"Compra por confirmar: el titular autoriz\u00f3 y el saldo queda apartado hasta que se pague el pedido.","4":"P\u00e1gina de pago con la tarjeta aplicada: el resumen del pedido descuenta lo que cubre la tarjeta."}},"plugin_section":[],"plugin_tags":[281527,39946,216685,284539,286],"plugin_category":[45],"plugin_contributors":[284541,284540],"plugin_business_model":[],"class_list":["post-165045","plugin","type-plugin","status-publish","hentry","plugin_tags-donaciones","plugin_tags-promociones","plugin_tags-socialhero","plugin_tags-tarjetas-de-regalo","plugin_tags-woocommerce","plugin_category-ecommerce","plugin_contributors-juanpablosh","plugin_contributors-socialhero","plugin_committers-juanpablosh","plugin_committers-socialhero"],"banners":{"banner":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/banner-772x250.png?rev=3729393","banner_2x":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/banner-1544x500.png?rev=3729393","banner_rtl":false,"banner_2x_rtl":false},"icons":{"svg":false,"icon":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/icon-128x128.png?rev=3729393","icon_2x":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/icon-256x256.png?rev=3729393","generated":false},"screenshots":[{"src":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/screenshot-1.png?rev=3729393","caption":"Carrito: el cliente elige pagar con su Tarjeta de Pago o Regalo con Sentido, o s\u00f3lo obtener los beneficios con su n\u00famero de afiliado."},{"src":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/screenshot-2.png?rev=3729393","caption":"Esperando la autorizaci\u00f3n del titular: tiempo restante, lo que cubre la tarjeta, Tokens Sociales a recibir y Tokens Premio."},{"src":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/screenshot-3.png?rev=3729393","caption":"Compra por confirmar: el titular autoriz\u00f3 y el saldo queda apartado hasta que se pague el pedido."},{"src":"https:\/\/ps.w.org\/socialhero-promotions\/assets\/screenshot-4.png?rev=3729393","caption":"P\u00e1gina de pago con la tarjeta aplicada: el resumen del pedido descuenta lo que cubre la tarjeta."}],"raw_content":"<!--section=description-->\n<p>Socialhero Promotions conecta tu tienda WooCommerce con Socialhero. En el carrito y en la p\u00e1gina de pago aparece un widget donde el cliente elige una de dos opciones (ninguna viene marcada):<\/p>\n\n<ul>\n<li><strong>Pagar y obtener beneficios Socialhero:<\/strong> 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\u00e1 la tarjeta. Una vez autorizada, el saldo queda apartado y se descuenta s\u00f3lo cuando se confirma el pago del pedido; lo que no cubra la tarjeta se paga con los medios de pago de la tienda.<\/li>\n<li><strong>Obtener beneficios Socialhero:<\/strong> escribe su n\u00famero de cuenta Socialhero y se aplican las promociones de los productos del carrito: los Tokens Sociales que recibir\u00e1 y, si tiene Tokens Premio, el descuento que puede aplicar autoriz\u00e1ndolo con la contrase\u00f1a de su cuenta.<\/li>\n<\/ul>\n\n<p>Adem\u00e1s:<\/p>\n\n<ul>\n<li>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.<\/li>\n<li>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\u00f3n a lo devuelto.<\/li>\n<li>En el pedido, en los correos y en el administrador se muestra lo que se pag\u00f3 con cada tarjeta.<\/li>\n<li>El administrador incluye un reporte de pagos con tarjetas Socialhero que se puede exportar a CSV.<\/li>\n<li>En la tienda y en las categor\u00edas se muestra una nota que indica que el pago con tarjetas se hace desde el carrito.<\/li>\n<li>Un bot\u00f3n \"Comprar ahora\" lleva un producto directo a la p\u00e1gina de pago.<\/li>\n<\/ul>\n\n<p>Para usar el plugin tu comercio necesita una cuenta de Socialhero con el servicio de tarjetas y\/o promociones activo.<\/p>\n\n<p><strong>Importante:<\/strong> el plugin viene en modo <strong>Sandbox (pruebas)<\/strong>. Para vender hay que cambiarlo a <strong>Producci\u00f3n<\/strong> y capturar las credenciales de API de producci\u00f3n. Solicita tus credenciales a tu contacto Socialhero.<\/p>\n\n<h3>External services<\/h3>\n\n<p>Este plugin se conecta a servicios de Socialhero (Socialhero, M\u00e9xico) para funcionar. Sin ellos no puede validar tarjetas ni promociones.<\/p>\n\n<p><strong>API de Socialhero<\/strong> (<code>https:\/\/api.socialhero.com.mx<\/code>)<\/p>\n\n<ul>\n<li>Se usa para validar el n\u00famero 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\u00f3n de Tokens Premio; confirmar, cancelar o reembolsar las ventas; y registrar los webhooks de la tienda.<\/li>\n<li>Se env\u00eda cuando el cliente valida su n\u00famero de cuenta o su tarjeta, cuando autoriza Tokens Premio, cuando se paga, cancela o reembolsa un pedido que us\u00f3 Socialhero, y cuando el administrador guarda la configuraci\u00f3n del plugin.<\/li>\n<li>Datos que se env\u00edan: el n\u00famero de cuenta Socialhero o el c\u00f3digo de la tarjeta; la contrase\u00f1a de la cuenta Socialhero s\u00f3lo al autorizar Tokens Premio (no se guarda en la tienda); los productos del carrito (c\u00f3digo, 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\u00f3n del sitio para los webhooks.<\/li>\n<\/ul>\n\n<p><strong>Im\u00e1genes de Socialhero<\/strong> (<code>https:\/\/socialhero.com.mx<\/code>)<\/p>\n\n<ul>\n<li>El widget muestra los \u00edconos 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\u00edan datos de la compra.<\/li>\n<\/ul>\n\n<p>T\u00e9rminos y condiciones: https:\/\/www.socialhero.com.mx\/terminos-condiciones\nAviso de privacidad: https:\/\/www.socialhero.com.mx\/politicas-privacidad<\/p>\n\n<!--section=installation-->\n<ol>\n<li>Instala y activa WooCommerce.<\/li>\n<li>Instala y activa Socialhero Promotions.<\/li>\n<li>Solicita a tu contacto Socialhero tus credenciales de API (usuario y contrase\u00f1a) de producci\u00f3n.<\/li>\n<li>En el men\u00fa <strong>Socialhero Promotions<\/strong> del administrador, en <strong>Ambiente de API<\/strong>, elige <strong>Producci\u00f3n<\/strong> y guarda. El plugin viene en <strong>Sandbox (pruebas)<\/strong>: mientras siga as\u00ed, las tarjetas y los beneficios no son reales.<\/li>\n<li>En la misma pantalla, usa <strong>Agregar credenciales<\/strong> (o <strong>Actualizar credenciales<\/strong>) para capturar las credenciales de producci\u00f3n y elige tu <strong>Sucursal<\/strong>.<\/li>\n<li>El widget aparece solo en el carrito y en la barra lateral de la p\u00e1gina de pago. Si prefieres otra ubicaci\u00f3n, usa los bloques <strong>\"Promociones Socialhero\"<\/strong> y <strong>\"Tarjeta Socialhero (aviso de pago)\"<\/strong> en el editor de bloques.<\/li>\n<\/ol>\n\n<!--section=faq-->\n<dl>\n<dt id=\"%C2%BFel%20plugin%20ya%20viene%20listo%20para%20vender%3F\"><h3>\u00bfEl plugin ya viene listo para vender?<\/h3><\/dt>\n<dd><p>No. Viene en modo <strong>Sandbox (pruebas)<\/strong>, que se conecta al ambiente de pruebas de Socialhero. Para vender, en <strong>Socialhero Promotions \u2192 Ambiente de API<\/strong> elige <strong>Producci\u00f3n<\/strong>, guarda y captura tus credenciales de API de producci\u00f3n. Si no las tienes, solic\u00edtalas a tu contacto Socialhero. Mientras falte algo, el administrador muestra un aviso.<\/p><\/dd>\n<dt id=\"actualic%C3%A9%20desde%20la%20versi%C3%B3n%201.0.x%20y%20el%20widget%20no%20funciona\"><h3>Actualic\u00e9 desde la versi\u00f3n 1.0.x y el widget no funciona<\/h3><\/dt>\n<dd><p>Las versiones 1.0.x usaban una credencial compartida que esta versi\u00f3n ya no usa. Cada tienda necesita sus propias credenciales de API: solic\u00edtalas a tu contacto Socialhero y capt\u00faralas en <strong>Socialhero Promotions<\/strong>. Si tu tienda estaba en modo \"Live\", el plugin la pasa a <strong>Producci\u00f3n<\/strong> autom\u00e1ticamente.<\/p><\/dd>\n<dt id=\"%C2%BFcu%C3%A1ndo%20se%20cobra%20la%20tarjeta%3F\"><h3>\u00bfCu\u00e1ndo se cobra la tarjeta?<\/h3><\/dt>\n<dd><p>S\u00f3lo 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.<\/p><\/dd>\n<dt id=\"%C2%BFpuedo%20desactivar%20el%20bot%C3%B3n%20%22comprar%20ahora%22%3F\"><h3>\u00bfPuedo desactivar el bot\u00f3n \"Comprar ahora\"?<\/h3><\/dt>\n<dd><p>S\u00ed. Agrega esto a tu tema o a un plugin de personalizaciones:<\/p>\n\n<pre><code>add_filter( 'socialhero_enable_buy_now_button', '__return_false' );\n<\/code><\/pre><\/dd>\n\n<\/dl>\n\n<!--section=changelog-->\n<p>Cambios de las versiones recientes. Ver <code>changelog.txt<\/code> para el historial completo.<\/p>\n\n<h4>2.1.35 - 2026-10-05<\/h4>\n\n<ul>\n<li>Aviso en el administrador mientras el plugin est\u00e9 en Sandbox (pruebas) o le falten las credenciales de API, con la indicaci\u00f3n de solicitarlas a tu contacto Socialhero.<\/li>\n<li>La pantalla de configuraci\u00f3n explica que el plugin viene en Sandbox y c\u00f3mo pasarlo a Producci\u00f3n.<\/li>\n<li>Las tiendas que actualizan desde 1.0.x conservan su modo: \"Live\" pasa a Producci\u00f3n y \"Test\" a Sandbox.<\/li>\n<li>Se quit\u00f3 de la configuraci\u00f3n un aviso viejo que dec\u00eda que la redenci\u00f3n de tarjetas estaba deshabilitada.<\/li>\n<\/ul>\n\n<h4>2.1.34 - 2026-10-03<\/h4>\n\n<ul>\n<li>El widget de beneficios del carrito y del checkout ahora tiene el mismo dise\u00f1o, textos y pasos que el de Shopify: bot\u00f3n morado \"Pagar y obtener beneficios Socialhero\", opciones con logos, campos y botones iguales, mensajes, resumen de lo que cubre la tarjeta y ventanas (modales).<\/li>\n<li>La tarjeta va en 2 pasos, como en Shopify: \"Validar tarjeta\" (s\u00f3lo revisa la tarjeta) y despu\u00e9s \"Continuar\" \/ \"Solicitar aprobaci\u00f3n de redenci\u00f3n\" (manda la solicitud al titular).<\/li>\n<li>Mientras el titular decide, una ventana muestra el tiempo que queda y permite cancelar la solicitud.<\/li>\n<li>El bot\u00f3n del carrito para ir a pagar dice \"Continuar con el pago\" cuando la tarjeta ya est\u00e1 en \"Compra por confirmar\", y \"Pagar por otros medios\" en todos los dem\u00e1s casos.<\/li>\n<li>El bot\u00f3n para quitar el beneficio aplicado ahora dice \"Cancelar\".<\/li>\n<li>Ninguna opci\u00f3n viene elegida al abrir el carrito o la p\u00e1gina de pago.<\/li>\n<li>El bot\u00f3n del n\u00famero de afiliado dice \"Validar cuenta Socialhero\".<\/li>\n<li>Al confirmar los ajustes de una tarjeta, la ventana muestra que se est\u00e1 enviando la solicitud al titular.<\/li>\n<li>Las ventanas del widget quedan por encima del bot\u00f3n de PayPal expr\u00e9s.<\/li>\n<li>En la tienda y las categor\u00edas aparece la nota \"Para Pagos con Tarjeta de Pago\/Regalo con Sentido, hacer compra a trav\u00e9s del Carrito.\"<\/li>\n<li>En el carrito cl\u00e1sico el widget se muestra junto a los totales.<\/li>\n<li>Se corrigieron acentos que sal\u00edan mal en algunos mensajes de la autorizaci\u00f3n de Tokens Premio.<\/li>\n<li>Al cancelar una solicitud de tarjeta, ya no vuelve a aparecer la ventana de espera ni el aviso de vencimiento; y si la cancelaci\u00f3n tarda en responder pero s\u00ed se hizo, ya no se marca la tarjeta como problema.<\/li>\n<\/ul>","raw_excerpt":"Tus clientes pagan con Tarjetas de Pago o de Regalo con Sentido y obtienen los beneficios Socialhero de tu tienda WooCommerce.","jetpack_sharing_enabled":true,"_links":{"self":[{"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin\/165045","targetHints":{"allow":["GET"]}}],"collection":[{"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin"}],"about":[{"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/types\/plugin"}],"replies":[{"embeddable":true,"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/comments?post=165045"}],"author":[{"embeddable":true,"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wporg\/v1\/users\/socialhero"}],"wp:attachment":[{"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/media?parent=165045"}],"wp:term":[{"taxonomy":"plugin_section","embeddable":true,"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_section?post=165045"},{"taxonomy":"plugin_tags","embeddable":true,"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_tags?post=165045"},{"taxonomy":"plugin_category","embeddable":true,"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_category?post=165045"},{"taxonomy":"plugin_contributors","embeddable":true,"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_contributors?post=165045"},{"taxonomy":"plugin_business_model","embeddable":true,"href":"https:\/\/ewe.wordpress.org\/plugins\/wp-json\/wp\/v2\/plugin_business_model?post=165045"}],"curies":[{"name":"wp","href":"https:\/\/api.w.org\/{rel}","templated":true}]}}