WWooshPayment docs
Risoluzione problemi

Email non arriva

Debug del problema "non ho ricevuto la mail di verifica / password reset / notifica ordine". Outlook Junk, SPF/DKIM/DMARC, blacklist.

3 min di lettura

TLDR: WooshPayment manda email solo al merchant (verify, welcome, password reset, notifica ordine, Apple Pay required) da noreply@wooshpayment.com via Resend. Se non ti arrivano, nel 90% dei casi sono in Junk/Spam (specie su Outlook/Hotmail). Sotto la diagnostica completa.

Caso 1 — Email arriva in Junk/Spam su Outlook/Hotmail

È il caso più comune nei primi invii. Outlook è particolarmente aggressivo con nuovi dominî mittente che non ha mai visto.

Soluzione operativa (lato destinatario)

  1. Apri Outlook/Hotmail → cartella Junk Email
  2. Trova la mail "Verifica la tua email — WooshPayment" o simile
  3. Click destro → "Non è posta indesiderata" → "Non bloccare mai il mittente"
  4. Aggiungi noreply@wooshpayment.com ai contatti

Da quel momento le successive arrivano in Inbox.

Soluzione tecnica (lato WooshPayment — già configurata)

DNS del dominio mittente wooshpayment.com:

  • SPF (record TXT sul root):

    v=spf1 include:secureserver.net include:_spf.resend.com -all
    • secureserver.net è il mail server GoDaddy
    • _spf.resend.com autorizza Resend a inviare per nostro conto
    • -all (hard fail) per email non autorizzate

  • DKIM (CNAME resend._domainkey.wooshpayment.com): configurato secondo i record forniti dal dashboard Resend

  • DMARC: non pubblicato. Roadmap.

Propagazione DNS

Dopo modifiche DNS: 5-60 minuti tipicamente, fino a 24h worst case.

Verifica:

dig TXT wooshpayment.com +short
# Deve includere: v=spf1 include:secureserver.net include:_spf.resend.com -all

Caso 2 — Mail nemmeno in Junk

Se non vedi proprio nulla:

  1. Cerca in tutta la mailbox per wooshpayment (a volte i client moderni nascondono in archivi)
  2. Verifica nello "Storico email" o "Filtri" se hai una regola che cancella o sposta
  3. Se hai una mail con dominio aziendale custom (es. tuo@tuoaziendaitaliana.it), controlla che il provider mail (Aruba, Register, GoDaddy) non abbia un anti-spam aggressivo lato server. Capita su PEC + alcuni provider IT minori.

Caso 3 — Email cliente con typo

Capita che il merchant si registri con mail@gmial.com invece di gmail.com. Niente da fare se non:

  • Re-register con email corretta
  • O scrivici a noreply@wooshpayment.com con prova identità per cambio email manuale

Tipi di email che mandiamo

Per la lista completa vedi Email transazionali. Sintesi:

  • email_verify (al signup)
  • welcome (al signup)
  • password_reset (su richiesta)
  • merchant_order_notification (a ogni ordine)
  • apple_pay_registration_required (se auto-register fallisce)

Tutte vanno al merchant, nessuna al cliente finale.

Cliente finale dice di non aver ricevuto la conferma ordine

Le email "ordine confermato" le manda il tuo store Shopify/Woo, non noi. Quindi:

  • Verifica nel pannello Shopify Admin → Settings → Notifications → Customer notifications
  • Verifica nel pannello Woo → Impostazioni → Email
  • Il template è del tuo store, il mittente è il tuo store. Se non arriva, è un problema di deliverability sul tuo dominio (richiede DKIM/SPF sul tuostore.com)

Cose da NON fare

  • Non mandare bulk newsletter dall'email di WooshPayment — siamo transactional only, non ESP. Per le newsletter usa Mailchimp, Brevo o il tuo ESP preferito
  • Non chiedere reset password 50 volte di seguito — il rate limit blocca per 15 min
  • Non aggiungere wooshpayment.com alla blocklist personale per errore

Diagnostica avanzata

Verifica record SPF/DKIM del nostro dominio

# SPF
dig TXT wooshpayment.com +short
 
# DKIM (Resend)
dig CNAME resend._domainkey.wooshpayment.com +short

Verifica reputation dominio mittente

mxtoolbox.com → "Domain Health Report" su wooshpayment.com. Deve essere verde su tutti i check principali.

Verifica del singolo invio

Se hai un ID transazione/ordine specifico:

  • Internamente i log Pino (90gg retention) tracciano ogni send con to, subject, attempts, errori
  • Se hai bisogno di un log specifico, scrivici a noreply@wooshpayment.com con l'email destinatario e la data approssimativa

Quando contattarci

Dopo i check sopra, se le email continuano a non arrivare:

Scrivi a noreply@wooshpayment.com allegando:

  • Email destinatario problematica
  • Tipo di email che ti aspettavi (verify, password reset, ecc.)
  • Data e ora approssimativa
  • Output di dig TXT wooshpayment.com +short e dig CNAME resend._domainkey.wooshpayment.com +short

Tempo medio risposta: 4h business hours.