# FaciConnect

> Documentação para programadores da FaciConnect — aceite pagamentos FaciPay (Multicaixa Express, Referência EMIS e FaciPay) na web, em Android, iOS e WooCommerce, em Angola (moeda AOA). Web SDK em JavaScript, SDKs nativas, plugin WooCommerce e uma API de parceiros (OAuth2) com webhooks verificados por HMAC SHA-256.

O Português é o idioma canónico. Cada página tem equivalente em Inglês (`/en/...`) e Francês (`/fr/...`) — substitua o prefixo `/pt/` pelo do idioma desejado.

- Produção: https://docs.faciconnect.com
- Domínios: `api.faciconnect.com`, `sandbox.api.faciconnect.com`, `cdn.faciconnect.com`

## Começar

- [Introdução](https://docs.faciconnect.com/pt/get-started/introduction): Explore os guias e exemplos de integração com o FaciConnect.
- [Quickstart](https://docs.faciconnect.com/pt/get-started/quickstart): Aceite o seu primeiro pagamento FaciPay em sandbox em ~10 minutos: SDK, botão, backend e webhook.
- [Conceitos essenciais](https://docs.faciconnect.com/pt/get-started/concepts): Chaves, ambientes, ciclo de vida da ordem e idempotência.
- [Integração de referência](https://docs.faciconnect.com/pt/get-started/sample-integration): Uma loja completa (Express + SQLite) que integra a FaciPay ponta a ponta — copie e adapte.
- [Construir com IA](https://docs.faciconnect.com/pt/get-started/build-with-ai): Copie um prompt pronto e integre a FaciPay com o seu assistente de IA — Cursor, Claude, v0 e mais.
- [Formas de interação de pagamento](https://docs.faciconnect.com/pt/get-started/payment-ux): Como o cliente paga no FaciPay hoje (popup) e o fluxo passo a passo do overlay web.
- [Segurança](https://docs.faciconnect.com/pt/get-started/security): Proteja segredos e valide o webhook do FaciPay com HMAC SHA-256 — passo a passo por framework.
- [Go-live checklist](https://docs.faciconnect.com/pt/get-started/go-live): Checklist para passar a FaciPay de sandbox a produção sem surpresas.

## Referência da API

- [Introdução à API](https://docs.faciconnect.com/pt/api-reference/introduction): A API de parceiros FaciConnect: URLs base, autenticação, erros e convenções (AOA).
- [Autenticação](https://docs.faciconnect.com/pt/api-reference/authentication): Obtenha e use access tokens da FaciConnect API (OAuth2 client credentials).
- [Webhooks](https://docs.faciconnect.com/pt/api-reference/webhooks): Receber, verificar e processar notificações de estado de pagamento.
- [Endpoint: Criar ordem de pagamento](https://docs.faciconnect.com/api-reference/payment-orders/criar-ordem-de-pagamento): Cria uma ordem de pagamento (playground interativo gerado a partir da spec OpenAPI).

## Web SDK

- [Visão geral](https://docs.faciconnect.com/pt/sdk/overview): A FaciPay JS SDK: botão de pagamento, popup e callbacks para aceitar pagamentos no browser.
- [Instalação](https://docs.faciconnect.com/pt/sdk/installation): Carregue a FaciPay JS SDK via CDN em Next.js, React, Vue, SvelteKit ou HTML puro.
- [FaciPay()](https://docs.faciconnect.com/pt/sdk/facipay): Inicializa a SDK e valida a chave publicável.
- [generateButton()](https://docs.faciconnect.com/pt/sdk/generate-button): Cria o botão de pagamento com callbacks e opções de aparência e pagamento.
- [Callbacks](https://docs.faciconnect.com/pt/sdk/callbacks): Assinaturas e shapes de dados de cada callback do botão.
- [Objeto Button](https://docs.faciconnect.com/pt/sdk/button-object): Métodos do botão devolvido por generateButton() e os objetos actions.
- [Eventos (postMessage)](https://docs.faciconnect.com/pt/sdk/events): Como o popup do checkout comunica com a sua página.
- [Tipos & enums](https://docs.faciconnect.com/pt/sdk/types): Referência de tipos, estados e métodos de pagamento da SDK.
- [Receita: Páginas de retorno](https://docs.faciconnect.com/pt/sdk/recipes/return-pages): Construir as páginas de sucesso, pendente e cancelado.
- [Receita: Referências múltiplas](https://docs.faciconnect.com/pt/sdk/recipes/multiple-references): Mostrar o valor total e vários itens no botão de pagamento.
- [Receita: Tratamento de erros](https://docs.faciconnect.com/pt/sdk/recipes/error-handling): Erros de pagamento, estados de loading e popups bloqueados.

## Android SDK

- [Visão geral](https://docs.faciconnect.com/pt/android/overview): Aceite pagamentos FaciPay numa app Android nativa (Kotlin) com a SDK oficial.
- [Instalação](https://docs.faciconnect.com/pt/android/installation): Adicionar a FaciPay Android SDK via Gradle (Maven Central).
- [Checkout](https://docs.faciconnect.com/pt/android/checkout): Iniciar um pagamento com FaciPayCheckout.start.
- [Callbacks & resultado](https://docs.faciconnect.com/pt/android/callbacks): FaciPayCallback, PaymentResult e tratamento de erros.

## iOS SDK

- [Visão geral](https://docs.faciconnect.com/pt/ios/overview): Aceite pagamentos FaciPay numa app iOS nativa (Swift) com a SDK oficial.
- [Instalação](https://docs.faciconnect.com/pt/ios/installation): Adicionar a FaciPay iOS SDK via Swift Package Manager ou CocoaPods.
- [Checkout](https://docs.faciconnect.com/pt/ios/checkout): Apresentar um pagamento com FaciPayCheckout.start.
- [Resultado & erros](https://docs.faciconnect.com/pt/ios/callbacks): CheckoutResult, PaymentResult e FaciPayError.

## WooCommerce

- [Visão geral](https://docs.faciconnect.com/pt/woocommerce/overview): Aceite FaciPay na sua loja WooCommerce — Multicaixa Express, Referência EMIS e FaciPay, sem código.
- [Instalação](https://docs.faciconnect.com/pt/woocommerce/installation): Descarregar, instalar e configurar o plugin FaciPay para WooCommerce.
- [Experiência de checkout](https://docs.faciconnect.com/pt/woocommerce/checkout-experience): Checkout clássico, WooCommerce Blocks e botões Express.
- [Webhooks](https://docs.faciconnect.com/pt/woocommerce/webhooks): Como o plugin recebe e valida as notificações de pagamento.

## Optional

- [Inglês (EN)](https://docs.faciconnect.com/en/get-started/introduction): Toda a documentação em Inglês — troque `/pt/` por `/en/` em qualquer URL acima.
- [Francês (FR)](https://docs.faciconnect.com/fr/get-started/introduction): Toda a documentação em Francês — troque `/pt/` por `/fr/` em qualquer URL acima.