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

Quickstart

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 tua 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 teu backend.

​
Métodos de pagamento

Na configuração allowedPaymentMethods podes esconder o Multicaixa Express e a Referência EMIS, mas o FaciPay directo 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 confies 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 aplicações web — frontend num browser (Next.js, React, Vue, HTML puro…) mais um backend HTTP. Não cobre apps mobile nativas (iOS, Android, React Native, Flutter), nem plugins de CMS/e-commerce (WordPress, Shopify, WooCommerce) — para esses, pede a documentação específica.

Próximo passo: Quickstart

Aceita o teu primeiro pagamento em sandbox.