WWooshPayment docs
Checkout

Email transazionali

Quali email manda WooshPayment, da quale mittente, con quale DNS. Le email al cliente finale le manda il tuo store, non noi.

2 min di lettura

TLDR: WooshPayment manda email solo al merchant (verify, welcome, password reset, notifica nuovo ordine, alert Apple Pay). Le email al cliente finale (conferma ordine, spedizione, recupero carrello) le manda il tuo store Shopify/Woo, non noi.

Email che mandiamo NOI

Mittente: noreply@wooshpayment.com via Resend, DKIM + SPF configurati su GoDaddy.

EmailQuando parteDestinatario
email_verifySubito al signupMerchant
welcomeSubito al signupMerchant
password_resetQuando il merchant chiede resetMerchant
merchant_order_notificationA ogni ordine completato/CODMerchant
apple_pay_registration_requiredSe l'auto-register Apple Pay sul Whop del merchant fallisceMerchant

Nessuna email cliente-facing è inviata da noi.

Perché NON mandiamo email al cliente

Decisione di prodotto:

  1. Branding: mandare "ordine confermato" da noreply@wooshpayment.com confonde il cliente che non sa chi è WooshPayment
  2. Deliverability: Shopify e Woo hanno deliverability superiore alla nostra perché hanno DKIM sul dominio del merchant
  3. Sincronizzazione: Shopify/Woo è già la source of truth per spedizione, tracking, fattura — mandare due email "ordine confermato" da fonti diverse crea confusione

Cosa significa nella pratica:

  • Cliente paga su WooshPayment → noi creiamo l'ordine via API → Shopify/Woo manda la sua mail "Ordine confermato" col template del merchant
  • Cliente lascia carrello a metà → non mandiamo nessuna email recovery (decisione di policy). Il cron /cron/abandoned-cart esiste ma fa solo housekeeping DB (marca PENDING → EXPIRED le sessioni scadute), niente send

Se in futuro vogliamo riattivare le recovery email al cliente, il send dovrà essere su SMTP per-merchant con DKIM sul dominio del merchant, non dal nostro noreply@wooshpayment.com. Roadmap.

DNS necessario lato WooshPayment (già configurato)

Per chi ne vuole sapere la configurazione attuale del nostro mittente:

SPF (su wooshpayment.com apex):

v=spf1 include:secureserver.net include:_spf.resend.com -all

secureserver.net è il GoDaddy mail (default), _spf.resend.com autorizza Resend a mandare per nostro conto.

DKIM (CNAME resend._domainkey.wooshpayment.com):

Configurato secondo i record forniti dal dashboard Resend.

DMARC: in roadmap. Oggi non lo pubblichiamo.

Test pre-produzione

Quando aggiungiamo un nuovo template (lato platform):

  1. Resend dashboard → "Send test"
  2. Verificare rendering su Gmail, Outlook, Apple Mail (Outlook è il peggiore)
  3. Test su mail-tester.com — puntiamo a ≥9/10
  4. Verificare anti-XSS escape su tutti i campi user-provided (shopName, customer.firstName, etc.)

Outlook spam folder

Capita che la prima email a un destinatario Outlook/Hotmail finisca in Junk. È normale per nuovi dominî mittente. Soluzioni:

  1. Il destinatario marca "Non spam" sul primo arrivo → arriva regolare alle successive
  2. Aggiungi noreply@wooshpayment.com ai contatti
  3. Vedi Email non arriva per la diagnostica completa

Personalizzazione

I template oggi non sono modificabili dalla dashboard merchant (sono hardcoded nel codice apps/api/src/services/EmailService.ts con escape XSS su tutti i campi dinamici).

Roadmap: editor template merchant-facing per gli alert al merchant. Non per email customer-facing — non le mandiamo per scelta.