A FaciConnect é a plataforma que liga a sua aplicação ao FaciPay, o sistema de pagamentos para Angola (moeda AOA). Com uma SDK de browser e uma API de parceiros, aceita pagamentos por Multicaixa Express, Referência EMIS e FaciPay (solicitação de pagamento) sem reconstruir o seu checkout.

Início rápido

Do zero ao primeiro pagamento em sandbox em ~10 minutos.

FaciPay JS SDK

O botão de pagamento, callbacks e referência completa.

API Reference

Endpoints de token, ordens e webhooks.

Integração de referência

Uma loja completa (Express + SQLite) ponta a ponta.

​
Como funciona um pagamento

A FaciConnect combina três peças: a SDK no frontend (renderiza o botão e abre o popup), a sua API no backend (cria a ordem e recebe o webhook) e a FaciPay (processa o pagamento).
O webhook é a fonte da verdade do estado do pagamento — não os callbacks do frontend. Os callbacks servem para a experiência do utilizador (redirecionar, mostrar referência); a confirmação definitiva vem do webhook no seu backend.

​
Métodos de pagamento

Na configuração allowedPaymentMethods pode esconder o Multicaixa Express e a Referência EMIS, mas o FaciPay direto permanece sempre visível.

​
Regras essenciais

  • Moeda AOA, locale pt-AO. O amount é inteiro, sem casas decimais (ex.: 15000 = 15.000 Kz).
  • O total é sempre recalculado no servidor — nunca confie no valor enviado pelo cliente.
  • O createOrder() da SDK tem de devolver uma string não-vazia (o referenceNumber).
  • Em produção, a SDK só funciona sobre HTTPS.

​
Acesso e credenciais

​
Âmbito

Esta documentação cobre a integração web — frontend num browser (Next.js, React, Vue, HTML puro…) mais um backend HTTP. Para outras plataformas há secções dedicadas: Android SDK, iOS SDK e WooCommerce. Ainda não cobrimos React Native, Flutter nem outros plugins de CMS/e-commerce (Shopify, WordPress sem WooCommerce) — para esses, fale com o suporte.

Próximo passo: Início rápido

Aceite o seu primeiro pagamento em sandbox.