Saltar a contenido

Solución de problemas

Usa la tabla de contenidos para ir directamente a tu problema, o busca una palabra clave.

Problemas con el correo de la tarjeta de regalo

El destinatario no recibió el correo de la tarjeta de regalo

Revisa estos puntos en orden:

  1. Carpeta de spam o correo no deseado — pide al destinatario que revise, incluidas las pestañas Promociones y Actualizaciones. Los correos de tarjetas de regalo a veces activan los filtros de spam.

  2. Error tipográfico en la dirección de correo — busca la tarjeta en la Gift cards sending queue (consulta Solución de problemas: tarjetas de regalo que no aparecen) y revisa la dirección. Un solo carácter incorrecto hace que el correo llegue a otro lugar. Gift Card Hero no puede detectar una dirección incorrecta, así que una dirección con errores seguirá mostrando Sent.

  3. Estado en la cola — la cola muestra Scheduled (esperando su fecha de entrega), Sending, Sent o Failed. Failed significa que Gift Card Hero se rindió tras varios intentos; haz clic en la dirección de correo para corregirla y guarda, lo que vuelve a enviar la tarjeta.

  4. Entrega programada — si el comprador eligió una fecha de entrega futura, el estado es Scheduled y no se envía nada hasta esa fecha.

  5. Dominio del remitente — si envías desde tu propio dominio, revisa sus registros SPF y DKIM. Un registro mal configurado puede hacer que el correo acabe en spam o se pierda. Si los recordatorios o las notificaciones de canje pasan por tu propio servidor de correo, revisa su conexión en Settings → Integrations.

  6. Vuelve a enviarla — abre la tarjeta de regalo en el admin de Shopify (Products → Gift cards) y usa Resend Gift Card en el bloque Gift Card Management. Puedes enviarla al cliente, al destinatario, al administrador de la tienda o a cualquier dirección que escribas. Consulta Bloque de administración de tarjetas de regalo.

El correo de la tarjeta de regalo se ve mal (problemas de estilo)

  1. Los clientes de correo suelen bloquear las imágenes externas de forma predeterminada. Si solo faltan las imágenes, el destinatario puede elegir mostrarlas.
  2. Vuelve a generar la plantilla en Settings → Email template y revisa la vista previa que se abre. Si se ve bien ahí pero mal en Gmail u Outlook, el problema está en el cliente de correo. Mantén el HTML personalizado sencillo y evita las imágenes de fondo en CSS; usa etiquetas <img> en su lugar.
  3. Si pegaste la plantilla en la notificación de tarjeta de regalo de Shopify (Settings → Notifications → Customer notifications → Gift card created), vuelve a pegar encima la plantilla recién generada. Consulta Plantillas de correo electrónico.

El correo muestra código sin procesar como {{ gift_card.code }}

La plantilla del editor de notificaciones de Shopify tiene un error de sintaxis, así que Shopify muestra los marcadores en lugar de reemplazarlos. Las causas habituales son un }} o %} que falta, o un texto cortado al pegar. Vuelve a generar la plantilla en Settings → Email template, cópiala y reemplaza toda la plantilla de notificación en Shopify.

Tarjetas de regalo que no aparecen

Si un cliente dice que no ha recibido su tarjeta de regalo, sigue los pasos de Solución de problemas: tarjetas de regalo que no aparecen. En resumen:

  1. Confirma que la tarjeta existe en Shopify admin → Products → Gift cards.
  2. Revisa su estado en la Gift cards sending queue (página de inicio → Recent gift card queue → View full report).
  3. Corrige la dirección y guarda, o vuelve a enviarla desde el bloque Gift Card Management.
  4. Si la tarjeta no se puede volver a enviar, emite una sustituta con Issue e-Gift card.

Widget de consulta de saldo

El widget no aparece en mi tienda online

  1. El app embed está desactivado — en la página de inicio, mira App Blocks Status. Si tu tema activo muestra Disabled, haz clic en Activate app embed, activa Gift Card Hero en el editor de temas y pulsa Save. Consulta Instalación y configuración.

  2. El widget está desactivado — abre Balance widget en el menú de la izquierda. Si la página muestra Gift card balance widget is Disabled, haz clic en Enable. (Algunas tiendas ven una versión más corta de esta página sin ese interruptor; en ese caso, el widget se controla solo con el app embed.)

  3. Lugar incorrecto — el widget está en tu página de consulta de saldo (https://[your-store].myshopify.com/a/gifthero/balance) o donde hayas añadido <div class="sc-hero-checker-container"></div>. Al añadir ese código a una página, usa el modo HTML del editor (el botón <>); si no, las etiquetas se mostrarán escapadas. Consulta Widget de consulta de saldo.

  4. Caché — fuerza la recarga de la tienda online (Ctrl+Shift+R, o Cmd+Shift+R en Mac).

  5. Tema antiguo — Gift Card Hero muestra We support only manual install for Shopify theme 1.0 en temas anteriores a Online Store 2.0. Haz clic en Contact support y te ayudaremos a instalarlo a mano.

La consulta de saldo dice que no encuentra mi tarjeta

La consulta de saldo busca las tarjetas solo por el código completo. Si escribes los últimos cuatro caracteres o un código parcial, no devuelve nada. Pide al cliente que introduzca el código completo que aparece en su correo.

El widget muestra un saldo o un estado incorrecto

Si un cliente acaba de gastar la tarjeta, recarga la página y vuelve a consultar. Una tarjeta caducada muestra Expired on seguido de la fecha, no "Active". Si los saldos son incorrectos siempre por la misma cantidad, contacta con soporte.

Problemas con los códigos de tarjeta de regalo

"Invalid gift card code" al pagar

  1. Error tipográfico — los códigos no distinguen mayúsculas, pero cada carácter debe ser exacto. Revisa el 0 (cero) frente a la O (letra O), y el 1 (uno) frente a la I (letra I).

  2. Tarjeta desactivada — es posible que la tarjeta se haya desactivado. Revisa su estado en Shopify admin → Products → Gift cards.

  3. Tarjeta caducada — revisa la fecha de caducidad de la tarjeta. Un código caducado ya no funciona.

  4. Tarjeta de otra tienda — una tarjeta de otra tienda de Shopify que no esté en tu red de Multi-Store no funcionará en tu pago.

  5. Saldo cero — una tarjeta totalmente usada no tiene nada que aplicar.

  6. Moneda — es posible que una tarjeta emitida en otra moneda no se acepte en la tuya. Revisa Cross-currency redemption en la pestaña E-Gift cards. Consulta las preguntas frecuentes.

Un código se rechaza en el POS pero funciona en línea

Revisa la configuración del POS en POS tools → Shopify POS. Si Allow only redeeming gift cards in POS está activado, el personal solo puede usar los códigos para pagar, no para recargarlos. Comprueba también que la tarjeta no esté caducada ni sea de otra tienda, como se indicó antes.

Problemas con el POS

Falta el icono de Gift Card Hero en Shopify POS

El icono no se añade automáticamente. En la app de Shopify POS:

  1. Pulsa Add tile.
  2. Ve a Apps.
  3. Selecciona Gift Card Hero.
  4. Pulsa POS UI Extension. (También existe la opción App link, pero está obsoleta.)
  5. Pulsa Done.

Los mismos pasos están en POS tools → Shopify POS dentro de Gift Card Hero. Si la app no aparece en la lista, actualiza la app de Shopify POS a la última versión y, en un iPad, ciérrala por completo y vuelve a abrirla. Consulta Integración con POS.

Recargar o registrar no está disponible en el POS

En POS tools → Shopify POS, revisa Disable balance reload functionality in Shopify POS app y Disable gift card registration in Shopify POS app. Si alguna de las dos está activada, esa acción se oculta para el personal.

Error "Failed to load" en el icono del POS

Normalmente significa que el dispositivo POS no puede conectarse con Gift Card Hero. Comprueba:

  • ¿El dispositivo tiene conexión a internet?
  • ¿Un firewall o un filtro de contenido bloquea las conexiones salientes?
  • ¿Funciona al cambiar de Wi-Fi a datos móviles (o al revés)?

En un POS de terceros, consulta Tarjetas de regalo en POS de terceros (PWA).

Operaciones masivas

El trabajo masivo parece bloqueado

Los trabajos grandes se ejecutan en segundo plano y pueden tardar, según los límites de frecuencia de Shopify.

  1. Abre el trabajo desde Bulk actions y marca Autorefresh import jobs en la página de resultados.
  2. Cada fila tiene un estado: Pending e In progress significan que aún se está procesando, Retrying significa un error temporal y Gift Card Hero volverá a intentarlo, Success significa que está terminado, y Failed significa que Gift Card Hero se rindió. Haz clic en Failed para ver el error.
  3. Un trabajo en curso no se puede pausar ni cancelar. Si no avanza durante mucho tiempo, contacta con soporte con el enlace del trabajo.

Las filas de mi envío masivo muestran "Failed"

Haz clic en la etiqueta Failed de la fila para leer el error. En Mass send, Gift Card Hero comprueba las direcciones antes de empezar y te indica cuáles no son válidas. En un CSV, la causa habitual son espacios extra o caracteres ocultos en la columna del correo, a menudo por culpa de Excel. Abre el archivo en un editor de texto, corrígelo y vuelve a subir solo las filas fallidas. Descarga la lista completa con Download results (csv).

El envío masivo terminó, pero algunos destinatarios dicen que no recibieron el correo

  1. Revisa los resultados. Las filas marcadas como Success se enviaron; pide a esos destinatarios que revisen el spam.
  2. Los servidores de correo corporativos suelen filtrar el correo masivo de remitentes nuevos.
  3. Si envías muchos correos a la vez, asegúrate de que los registros SPF y DKIM de tu dominio remitente estén configurados.

Analítica

Mi panel muestra $0 en todas las métricas

  1. Permiso — la analítica necesita acceso a todo tu historial de pedidos. Si ves Additional permissions required, haz clic en Give the app additional scope y apruébalo en Shopify.
  2. Sincronización — la analítica se genera a partir de datos sincronizados. Haz clic en Sync Data en la página de Analytics y elige Sync for period o Sync for all time. Un banner muestra el progreso. Si una sincronización se detiene, puedes pulsar Cancel sync y volver a intentarlo.
  3. Intervalo de fechas — revisa el intervalo de fechas en la parte superior de la página.

Sales lift muestra 0 o un valor muy bajo

Sales lift es el importe que los clientes gastan por encima del valor de la tarjeta de regalo. Si cada tarjeta cubre todo el pedido, no hay nada extra que contar. Esto es normal en pedidos de bajo valor o con tarjetas de alto valor.

Las analíticas de tarjetas de regalo no incluyen mi crédito de la tienda por fidelidad

El crédito de la tienda por fidelidad se informa en su propia pestaña Loyalty & promotions de la página de Analytics, no en los totales de tarjetas de regalo. Consulta Analítica de fidelidad.

Contactar con soporte

Si ninguna de las opciones anteriores resuelve tu problema, haz clic en Get help en la página de inicio, o en Contact us al final de cualquier página, e incluye:

  • El dominio de tu tienda (.myshopify.com)
  • Una descripción de lo que esperabas frente a lo que ocurrió
  • Los últimos cuatro caracteres de la tarjeta de regalo o el enlace del trabajo masivo, si aplica
  • Una captura de pantalla de los mensajes de error

El tiempo de respuesta suele ser de 1 día laborable.