Receber com cartão, Apple Pay, Google Pay e débito direto (Stripe)
Liga o Stripe para aceitar cartões de crédito e débito, Apple Pay, Google Pay e Débito Direto SEPA, com reembolsos devolvidos automaticamente.
Neste artigo
Os pagamentos com cartão chegam à Feitora através do Stripe, um dos maiores processadores de pagamentos do mundo. O cliente escolhe "Cartão de crédito/débito" no checkout, é levado para a página segura do Stripe (Stripe Checkout) e volta à tua loja com a encomenda paga. Os dados do cartão nunca passam pela tua loja.
Na mesma página do Stripe o cliente pode pagar com Apple Pay ou Google Pay, se estiverem ativos na tua conta Stripe e o aparelho dele os suportar.
Antes de começar
Cria uma conta em stripe.com e conclui a verificação da empresa (o Stripe pede os dados da empresa, um documento de identificação e o IBAN para onde transfere as vendas).
No painel do Stripe, em Developers → API keys, vais precisar da chave publicável (
pk_…) e da chave secreta (sk_…).Só o proprietário da loja altera as definições de pagamento.
Ligar o Stripe à loja
- Passo 1:
No painel, abre Definições → Pagamentos.
- Passo 2:
Desce até ao cartão Stripe (cartão, Apple Pay, Google Pay).
- Passo 3:
Cola a Chave pública e a Chave secreta.
- Passo 4:
Copia o Endpoint do webhook (configurar no Stripe) com o botão ao lado do campo.
- Passo 5:
No Stripe, abre Developers → Webhooks, carrega em Add endpoint, cola o endereço e escolhe os eventos (lista abaixo).
- Passo 6:
O Stripe mostra o Signing secret do webhook (
whsec_…). Copia-o para o campo Segredo do webhook na Feitora. - Passo 7:
Carrega em Guardar.
- Passo 8:
Em Métodos de pagamento, liga Cartão de crédito/débito (e, se quiseres, Débito Direto SEPA) e guarda outra vez.
Eventos a escolher no webhook
| Evento | Para que serve |
|---|---|
checkout.session.completed | Marca a encomenda como paga quando o cliente paga com cartão. |
checkout.session.async_payment_succeeded e checkout.session.async_payment_failed | Pagamentos que só confirmam mais tarde, como o Débito Direto SEPA. |
checkout.session.expired | O cliente abandonou a página de pagamento: a tentativa fica como falhada e ele pode tentar outra vez. |
payment_intent.succeeded e payment_intent.payment_failed | Cobranças automáticas das subscrições. |
Débito Direto SEPA
O Débito Direto SEPA cobra diretamente numa conta bancária (IBAN). É útil sobretudo para subscrições. Tem uma diferença importante: o banco só confirma o pagamento alguns dias depois. Até lá a encomenda fica por pagar; se o banco recusar, a tentativa passa a falhada e o cliente pode pagar de outra forma.
Reembolsos
Quando reembolsas uma encomenda paga com cartão (no detalhe da encomenda, Reembolsar), a Feitora pede o reembolso ao Stripe e o dinheiro volta ao cartão do cliente — a cronologia mostra "devolvido automaticamente no Stripe". Também podes reembolsar só uma parte. Vê Devoluções e reembolsos.
Vender noutras moedas
Se usas mercados e moedas, o Stripe cobra o cliente na moeda que ele escolheu no site. O MB WAY, o Multibanco e os métodos manuais cobram sempre em euros.
Problemas frequentes
| Problema | O que fazer |
|---|---|
| O cartão não aparece no checkout | Confirma que o método Cartão de crédito/débito está ligado e que a Chave secreta está preenchida. Fora do modo de testes, sem chave secreta o cartão não aparece. |
| Não aparece Apple Pay nem Google Pay | Ativa-os no painel do Stripe (Settings → Payment methods). Só aparecem em aparelhos e browsers compatíveis. |
| O cliente pagou e a encomenda está por pagar | Verifica o endpoint e os eventos do webhook no Stripe e se o Segredo do webhook corresponde a esse endpoint. |