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: pubblicato in monitoring mode (p=none). Prima della certificazione completa money-path lo portiamo almeno a p=quarantine.

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 hello@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)
  • customer_order_confirmation (al cliente finale dopo ordine creato)
  • merchant_order_notification (al merchant a ogni ordine)
  • apple_pay_registration_required (se auto-register fallisce)

Le prime tre vanno al merchant; la conferma ordine va al cliente finale col nome dello store come mittente.

Cliente finale dice di non aver ricevuto la conferma ordine

La conferma ordine cliente viene inviata da WooshPayment via Resend, brandizzata col nome dello store. Quindi:

  • Verifica in Dashboard → Ordini che l'ordine sia COMPLETED
  • Controlla nei log checkout/live logs l'evento server_customer_order_email con sent: true
  • Se sent: false, il provider email non ha accettato l'invio: controlla configurazione Resend/fromEmail o apri supporto indicando il token ordine
  • Se sent: true ma il cliente non la trova: controllare Spam/Promozioni, typo email cliente e blocchi del dominio mittente
  • Su WooCommerce possono partire anche email Woo se abilitate: quelle dipendono dal tuo store, ma non sostituiscono la conferma certificata WooshPayment

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 hello@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 hello@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.