# Gateways de Pagamento Para uma Loja WooCommerce

Source: https://support.kapsulehost.com/pt-pt/site-payments

O separador Pagamentos apresenta os gateways de pagamento disponíveis para a sua loja WooCommerce, mostra quais estão instalados e quais estão activados, e disponibiliza instalação e activação num clique para poder passar de uma loja sem checkout a uma loja a receber pagamentos com cartão em poucos minutos.

## Onde Fica o Separador Pagamentos

Abra **Websites**, clique na loja, abra o grupo **WordPress** no menu esquerdo do site e escolha **Pagamentos**. A página chama-se **Gateways de pagamento**.

O separador só aparece em sites criados como sites WooCommerce. Se o site for uma instalação WordPress simples, o item de menu não é apresentado e, se mesmo assim aceder à página, verá um banner de upgrade em vez da lista de gateways. Verifique o indicador de stack junto ao nome do site, no topo da página, para ver como o site está classificado.

![Página de gateways de pagamento para uma loja WooCommerce no KPanel](https://support.kapsulehost.com/help/screenshots/site-payments.23b0b42c.webp)

## Os Gateways Disponíveis

| Gateway | O que processa |
|---|---|
| Stripe | Cartões, Apple Pay e Google Pay |
| PayPal | PayPal e cartões |
| Afterpay | Compre agora, pague depois |
| POLi | Transferência bancária da Nova Zelândia |
| Windcave | Processamento de cartões e EFTPOS na Nova Zelândia |

Os gateways especialmente relevantes para comerciantes da Nova Zelândia têm um indicador **NZ** na lista.

> **Note:** A Apple Pay e a Google Pay não precisam de gateway próprio. Vêm incluídas com a Stripe, e o painel indica isso mesmo na linha da Stripe. Activar a Stripe é suficiente.

## Interpretar os Indicadores de Estado

Cada linha mostra um de três estados:

- **Connected**, a verde: o plugin está instalado e activo. Está a participar no seu checkout.
- **Installed**, a âmbar: o plugin está no site mas desactivado. Os clientes não o veem.
- **Available**, a cinzento: o plugin ainda não está instalado.

A maioria dos gateways aqui apresentados vêm pré-instalados mas inactivos quando uma loja WooCommerce é criada, o que é propositado. Um gateway activo sem credenciais associadas pode quebrar o checkout, por isso nada fica activado até decidir activá-lo.

## Activar um Gateway

1. Encontre o gateway na lista.
2. Clique em **Enable** se já estiver instalado, ou em **Instalar e activar** se não estiver.
3. Aguarde até o indicador de estado ficar verde e indicar **Connected**.
4. Clique em **Configure**.

**Configure** abre a própria página de definições do gateway dentro da administração WordPress da sua loja, num novo separador, já no ecrã correcto. É aí que coloca as credenciais da sua conta: as chaves de API, o ID de comerciante ou o número de conta que o fornecedor de pagamentos lhe atribuiu.

> **Warning:** Um gateway não está a receber pagamentos só porque o indicador diz Connected. Connected significa que o plugin está activo, não que está configurado. Até introduzir as suas próprias credenciais de conta no WooCommerce e concluir uma encomenda de teste real, considere o checkout como não finalizado.

## Gateways Que Instala Você Mesmo

Nem todos os gateways são distribuídos através do directório de plugins do WordPress. A Windcave é o exemplo aqui: a sua linha mostra um botão **Obter plugin** que o leva para a própria página de transferência do fornecedor, em vez de um botão de instalação.

Nesses casos, a sequência é:

1. Clique em **Obter plugin** e transfira o plugin a partir do fornecedor.
2. Na administração WordPress da sua loja, aceda a Plugins, depois a Adicionar Novo, e carregue o ficheiro.
3. Active-o aí.
4. Volte ao separador Pagamentos e clique em **Configure** para aceder às suas definições.

Depois de instalado, aparece com um indicador de estado normal como qualquer outro gateway.

## Desactivar um Gateway

Clique em **Disable** numa linha com estado **Connected**. O plugin permanece instalado mas deixa de estar activo, pelo que desaparece imediatamente do seu checkout e o indicador volta a **Installed**.

Desactive em vez de eliminar quando estiver a suspender um meio de pagamento, por exemplo enquanto resolve um problema de conta com o fornecedor. A configuração mantém-se, pelo que reactivá-lo mais tarde não implica voltar a introduzir as credenciais.

## Escolher O Que Activar

Ter mais gateways não é automaticamente melhor. Cada opção no checkout é mais uma decisão que o cliente tem de tomar, e cada fornecedor é mais uma conta a reconciliar.

Uma configuração comum na Nova Zelândia é um processador de cartões mais uma alternativa:

- **Cartões**: Stripe ou Windcave. A Stripe é o caminho mais rápido se quiser Apple Pay e Google Pay sem trabalho adicional; a Windcave é a opção a considerar se já tiver uma relação de EFTPOS ou de comerciante estabelecida através dela.
- **Uma alternativa**: PayPal pela familiaridade, Afterpay se o valor médio das suas encomendas se adequar a pagamentos em prestações, ou POLi se os seus clientes preferirem pagar directamente a partir de uma conta bancária.

Teste cada um dos que activar com uma encomenda real e pequena antes de o anunciar. Todos os fornecedores têm um modo de teste ou sandbox; utilize-o e depois faça uma transacção real e reembolse-a.

## Resolução de Problemas

**Um aviso diz que não foi possível ler o estado do plugin.** O painel pergunta directamente ao WordPress quais os plugins instalados e activos. Se o WordPress não conseguir responder, por exemplo porque o site está em modo de manutenção ou com erros, a lista é apresentada com um aviso de que o estado pode estar incompleto. Resolva o problema subjacente do site e depois actualize a página: [Registos de Erros](https://support.kapsulehost.com/pt-pt/error-logs) e [Ecrã Branco do WordPress](https://support.kapsulehost.com/pt-pt/wordpress-white-screen) são os passos habituais a seguir.

**A lista aparece vazia.** A loja não reportou qualquer plugin de gateway reconhecido. Confirme que o próprio WooCommerce está instalado e activo no site.

**Aparece um banner de upgrade em vez da lista.** O site não está registado como site WooCommerce. Isso é uma característica do site, não algo que possa alternar aqui.

**A activação é bem sucedida mas o gateway não aparece no checkout.** Quase sempre faltam credenciais, ou o gateway está activado no KPanel mas continua desactivado no seu próprio ecrã de definições do WooCommerce. Abra **Configure** e verifique ambos.

**Os pagamentos com cartão falham com um erro genérico.** Verifique primeiro os próprios registos do gateway no WooCommerce e depois o registo de erros do site. Chaves reais coladas em campos de modo de teste, e o inverso, é a causa mais comum.

## Próximos Passos

- [WooCommerce na KapsuleHost](https://support.kapsulehost.com/pt-pt/wordpress-woocommerce) para a configuração mais alargada da loja.
- [Registo de Actividade do Site](https://support.kapsulehost.com/pt-pt/site-activity-log) regista todas as alterações de gateway feitas a partir desta página.
- [Fazer uma Cópia de Segurança](https://support.kapsulehost.com/pt-pt/taking-a-backup) antes de alterar seja o que for numa loja em funcionamento.