A FaciConnect API é uma API REST de parceiros para criar e consultar ordens de pagamento, gerar referências de pagamento e realizar transferências em lote para carteiras FaciPay. É consumida pelo seu backend — nunca diretamente pelo browser, porque exige o clientSecret.

​
URLs base

​
Autenticação

Em dois passos:
  1. Troque clientId/clientSecret por um access_token em POST /token.
  2. Use Authorization: Bearer <access_token> nos restantes endpoints.

​
Convenções

​
integer / string / number
Em createPaymentOrder, envie amount como inteiro em AOA, sem decimais (15000 = 15.000 Kz). Em generatePaymentReference, envie amount como number em AOA (15000); aplicam-se os limites do sistema de referências Multicaixa. Em bulkTransfer, cada value tem de ser superior a zero e aceita decimais; o total do lote não pode exceder o saldo disponível.
​
string
A sua publishableKey sem o prefixo pk_test_/pk_live_. Em generatePaymentReference, o nome do campo é dsApplicationUUID.
​
header
Idioma das mensagens: pt (predefinido), en, fr.

​
Formato de erros

O exemplo seguinte corresponde ao erro de autenticação já documentado:
Os códigos 404 e 422 acima correspondem aos endpoints de consulta e criação de ordens já documentados. Consulte o contrato de cada serviço: generatePaymentReference e bulkTransfer devolvem os dados de sucesso em body.data, dentro do envelope code/body. Os códigos HTTP e os valores de code dos erros de negócio e internos destes novos serviços estão a confirmar com a equipa FaciPay.

​
Endpoints

POST /token

Obter access token.

POST /facipaypartner/createPaymentOrder

Criar ordem de pagamento.

GET /facipaypartner/paymentByExternalTransaction

Consultar estado (fallback).

POST /facipaypartner/generatePaymentReference

Novo — Gerar uma referência Multicaixa para pagamento.

POST /facipaypartner/bulkTransfer

Novo — Transferir para até 500 carteiras, de forma síncrona e atómica.

Webhook

Notificações de estado (fonte da verdade).
A referência completa de cada endpoint — com playground interativo — está no grupo Endpoints da barra lateral, gerada a partir da especificação OpenAPI.