Documentazione

WooCommerce – primi passi

1. Crea un account e scarica il plugin – oppure parti direttamente da WordPress: il plugin può creare il tuo account durante il collegamento.
2. In WordPress vai su Plugin → Aggiungi nuovo → Carica plugin, carica lo ZIP e attivalo.
3. Apri WooCommerce → MrUpsell e clicca su Connect to MrUpsell. Conferma il tuo negozio su mrupsell.com e vieni riportato subito indietro – collegato con un clic, senza chiavi da copiare.
4. Crea la tua prima regola in WooCommerce → MrUpsell → Offers.

Requisiti

• WordPress 6.2+, WooCommerce 8+, PHP 8.1+, HTTPS.
• Per il one-click: WooCommerce Stripe Gateway e/o WooCommerce PayPal Payments (≥ 4.1.2, vaulting attivo).

Configurare i pagamenti per il one-click

MrUpsell addebita l'upsell tramite il plugin di pagamento che il tuo negozio usa già – il denaro arriva direttamente sul tuo account Stripe o PayPal. Non servono chiavi aggiuntive né un nuovo fornitore di pagamenti.

• Stripe (carte, Apple Pay, Google Pay): installa il WooCommerce Stripe Gateway ufficiale e attiva i pagamenti con carta. Tutto qui – non appena una regola MrUpsell è attiva, durante il primo acquisto la carta viene mantenuta automaticamente utilizzabile per l'addebito successivo. Se la banca richiede il 3-D Secure, il cliente conferma direttamente nella thank-you page.
• PayPal con un clic: usa WooCommerce PayPal Payments 4.1.2 o successivo, attiva lì il vaulting (“Save PayPal and Venmo”) e abilita PayPal one-click in WooCommerce → MrUpsell → Settings. PayPal deve aver abilitato il vaulting per il tuo account merchant.
• PayPal con due clic (predefinito): senza vaulting, MrUpsell reindirizza brevemente il cliente a PayPal per l'upsell – i suoi dati sono già compilati. Scegli questa opzione se vuoi mantenere “Paga dopo”/le rate nella finestra PayPal: con il vaulting attivo PayPal nasconde queste opzioni.
• Altri metodi di pagamento (fattura, bonifico, Klarna, SEPA …): per questi ordini l'offerta semplicemente non viene mostrata – al checkout non cambia nulla.
• Test: attiva la modalità di test del tuo plugin di pagamento, effettua un ordine di prova e accetta l'offerta. Il riquadro MrUpsell nella schermata dell'ordine nell'admin WooCommerce mostra per ogni ordine perché un'offerta è stata o non è stata visualizzata – oppure, come shop manager, aggiungi ?mrupsell_debug=1 all'URL della thank-you page.

Shopify – primi passi

1. Installa MrUpsell dallo Shopify App Store e approva l'addebito a consumo (il revenue share viene fatturato da Shopify).
2. Vai su Impostazioni → Checkout → Pagina post-acquisto e seleziona MrUpsell.
3. Crea la tua prima regola nell'admin MrUpsell all'interno di Shopify.
4. Il tuo account per la dashboard MrUpsell viene creato automaticamente (link di accesso via email). Per mostrare il negozio in un altro workspace, usa un codice di collegamento da Dashboard → Negozi → Collega Shopify.

Regole di offerta

Una regola ha un trigger (prodotti o categorie, totale dell'ordine, tipo di cliente, metodi di pagamento), da uno a tre step di funnel (sempre / dopo accettazione / dopo rifiuto), un countdown e personalizzazioni di design opzionali. Per ogni ordine viene mostrata esattamente una regola – quella corrispondente con il numero di priorità più basso.

Prezzi e fatturazione

Non ci sono piani né abbonamenti. MrUpsell addebita il 3 % del fatturato upsell che genera (ordini upsell accettati meno i rimborsi), fatturato ogni settimana a consuntivo. Tutte le funzioni sono incluse: regole illimitate, funnel a 3 step e negozi illimitati. Le commissioni sono calcolate sugli ordini upsell comunicati dal tuo negozio – ogni ordine fatturato è elencato nella dashboard.

WooCommerce: salva una carta o PayPal in Dashboard → Fatturazione – le offerte vanno online solo quando è presente un metodo di pagamento, e non viene addebitato nulla in anticipo. Shopify: la commissione è un addebito a consumo con tetto massimo sulla tua fattura Shopify, e il tuo account per la dashboard MrUpsell viene creato automaticamente quando installi l'app.

API per sviluppatori

L'API dell'hub (/api/v1) è usata dal plugin e dall'app Shopify. Il contratto è documentato nel repository in docs/API-CONTRACT.md.

Serve aiuto?

Contattaci – il supporto prioritario è incluso per ogni merchant.