Documentação

WooCommerce – primeiros passos

1. Crie uma conta e descarregue o plugin – ou comece diretamente no WordPress: o plugin pode criar a conta durante a ligação.
2. No WordPress, vá a Plugins → Adicionar novo → Carregar plugin, carregue o ZIP e ative-o.
3. Abra WooCommerce → MrUpsell e clique em Connect to MrUpsell. Confirme a loja em mrupsell.com e é reencaminhado de volta – ligação feita com um clique, sem chaves para copiar.
4. Crie a primeira regra em WooCommerce → MrUpsell → Offers.

Requisitos

• WordPress 6.2+, WooCommerce 8+, PHP 8.1+, HTTPS.
• Para one-click: WooCommerce Stripe Gateway e/ou WooCommerce PayPal Payments (≥ 4.1.2, vaulting ativado).

Configurar pagamentos para one-click

O MrUpsell cobra o upsell através do plugin de pagamento que a loja já utiliza – o dinheiro vai diretamente para a sua própria conta Stripe ou PayPal. Não são necessárias chaves adicionais nem um novo prestador de pagamentos.

• Stripe (cartões, Apple Pay, Google Pay): instale o WooCommerce Stripe Gateway oficial e ative os pagamentos com cartão. É tudo – assim que uma regra MrUpsell estiver ativa, o cartão é automaticamente mantido utilizável para a cobrança posterior durante a primeira compra. Se o banco exigir 3-D Secure, o cliente confirma diretamente na página de agradecimento.
• PayPal com um clique: use o WooCommerce PayPal Payments 4.1.2 ou superior, ative aí o vaulting (“Save PayPal and Venmo”) e ligue PayPal one-click em WooCommerce → MrUpsell → Settings. O PayPal tem de ter ativado o vaulting para a sua conta de comerciante.
• PayPal com dois cliques (predefinição): sem vaulting, o MrUpsell redireciona brevemente o cliente para o PayPal para o upsell – os dados já estão preenchidos. Escolha esta opção para manter “Pagar mais tarde”/prestações na janela do PayPal: com o vaulting ativado, o PayPal oculta essas opções.
• Outros métodos de pagamento (fatura, transferência bancária, Klarna, SEPA …): a oferta simplesmente não é apresentada nessas encomendas – nada muda no checkout.
• Testes: ative o modo de teste do plugin de pagamento, faça uma encomenda de teste e aceite a oferta. A caixa MrUpsell no ecrã da encomenda no admin do WooCommerce mostra, para cada encomenda, porque é que uma oferta foi ou não apresentada – ou, como gestor da loja, acrescente ?mrupsell_debug=1 ao URL da página de agradecimento.

Shopify – primeiros passos

1. Instale o MrUpsell a partir da Shopify App Store e aprove a cobrança por utilização (o revenue share é faturado pela Shopify).
2. Vá a Definições → Finalização da compra → Página pós-compra e selecione MrUpsell.
3. Crie a primeira regra no admin do MrUpsell dentro da Shopify.
4. A conta da dashboard MrUpsell é criada automaticamente (link de início de sessão por email). Para mostrar a loja noutro workspace, use um código de ligação em Dashboard → Lojas → Ligar Shopify.

Regras de oferta

Uma regra tem um trigger (produtos ou categorias, total da encomenda, tipo de cliente, métodos de pagamento), um a três passos de funnel (sempre / após aceitação / após recusa), um countdown e personalizações de design opcionais. É apresentada exatamente uma regra por encomenda – a que corresponder e tiver o número de prioridade mais baixo.

Preços e faturação

Não há planos nem subscrição. O MrUpsell cobra 3 % da receita de upsell que gera (encomendas de upsell aceites menos reembolsos), faturada semanalmente a posteriori. Todas as funcionalidades estão incluídas: regras ilimitadas, funnels de 3 passos e lojas ilimitadas. As comissões são calculadas a partir das encomendas de upsell que a loja comunica – cada encomenda faturada está listada na dashboard.

WooCommerce: guarde um cartão ou PayPal em Dashboard → Faturação – as ofertas só ficam ativas quando existe um método de pagamento guardado, e nada é cobrado antecipadamente. Shopify: a comissão é uma cobrança por utilização com limite máximo na fatura Shopify, e a conta da dashboard MrUpsell é criada automaticamente ao instalar a app.

API para programadores

A API do hub (/api/v1) é usada pelo plugin e pela app Shopify. O contrato está documentado no repositório em docs/API-CONTRACT.md.

Precisa de ajuda?

Contacte-nos – o suporte prioritário está incluído para todos os comerciantes.