# Instalação

Descarregar, instalar e configurar o plugin FaciPay para WooCommerce.

import { PLUGIN_VERSION } from '/snippets/plugin-version.mdx';

## 1. Descarregar o plugin

Como o plugin ainda não está no diretório WordPress.org, descarregue o `.zip` da versão que
pretende:

<Card title={`Descarregar — v${PLUGIN_VERSION} (latest)`} icon="download" href={`https://cdn.faciconnect.com/plugins/wordpress/facipay/v${PLUGIN_VERSION}/woocommerce-gateway-facipay.zip`}>
  woocommerce-gateway-facipay.zip
</Card>

Os downloads seguem um **URL versionado** — basta concatenar a versão pretendida:

```
https://cdn.faciconnect.com/plugins/wordpress/facipay/{versão}/woocommerce-gateway-facipay.zip
```

| Versão | Download |
|---|---|
| **v{PLUGIN_VERSION}** (latest) | <a href={`https://cdn.faciconnect.com/plugins/wordpress/facipay/v${PLUGIN_VERSION}/woocommerce-gateway-facipay.zip`} target="_blank" rel="noopener">woocommerce-gateway-facipay.zip</a> |

<Note>
**Atualizações automáticas.** Depois de instalado, o plugin traz um **auto-updater** que
consulta `cdn.faciconnect.com/plugins/wordpress/facipay/…update-info.json` e oferece a nova
versão no painel do WordPress — como qualquer plugin do diretório oficial.
</Note>

<Tip>
Em breve esta secção terá um **seletor de versões** interativo (com "latest" por defeito) que
gera o link de download automaticamente.
</Tip>

## 2. Instalar e ativar

<Steps>
  <Step title="Pré-requisitos">
    WooCommerce instalado e ativo; moeda da loja definida como **AOA** (Definições → Geral).
  </Step>
  <Step title="Carregar o plugin">
    WP Admin → **Plugins → Adicionar novo → Carregar plugin** → escolha o `.zip` → **Instalar**.
  </Step>
  <Step title="Ativar">
    Clique em **Ativar** na lista de plugins.
  </Step>
</Steps>

## 3. Configurar as credenciais

Vá a **WooCommerce → Definições → Pagamentos → FaciPay**. Na primeira visita aparece um
**assistente de configuração**. Introduza as quatro credenciais fornecidas pela FaciPay:

| Campo | Formato esperado |
|---|---|
| **Publishable Key** | `pk_live_…` / `pk_test_…` |
| **Client ID** | `ci_live_…` / `ci_test_…` |
| **Client Secret** | `sk_live_…` / `sk_test_…` |
| **Webhook Secret** | (sem prefixo) |

<Warning>
Todas as chaves têm de pertencer ao **mesmo ambiente** (todas `…_live_` **ou** todas
`…_test_`). As credenciais são guardadas **encriptadas** (AES-256-CBC).
</Warning>

Grave. Depois de configurado:

- Aparece o botão **Testar ligação** (valida as credenciais contra a API).
- Aparece **Repor credenciais** (apaga as credenciais e reinicia o assistente).
- Marque a caixa **Ativar FaciPay Gateway**.

## 4. Configurar o webhook

Na página de definições, o **URL do webhook** é gerado automaticamente:

```
https://a-sua-loja.com/wp-json/facipay/v1/incoming
```

Copie-o e envie-o à equipa FaciPay para registo. É por aqui que a FaciPay confirma os
pagamentos (ver [Webhooks](/pt/woocommerce/webhooks)).

## 5. Obter credenciais

<Note>
**Como obter as credenciais.** As chaves (`pk_…`, `clientId`, `clientSecret`, `webhookSecret`)
são emitidas pela FaciPay após abrir uma **conta de negócio** e assinar contrato com a
área comercial da **Faci-X**. Para começar, fale connosco: 📞 +244 923 168 670 · ✉️ [atendimento@faci-x.ao](mailto:atendimento@faci-x.ao).
</Note>

<Card title="Próximo passo: Experiência de checkout" icon="arrow-right" href="/pt/woocommerce/checkout-experience">
  Checkout clássico, Blocks e botões Express.
</Card>