A FaciConnect API é uma API REST de parceiros para criar e consultar ordens de pagamento. É consumida pelo teu backend — nunca diretamente pelo browser, porque exige o clientSecret.

​
URLs base

AmbienteBase URL
Sandboxhttps://sandbox.api.faciconnect.com
Produçãohttps://api.faciconnect.com

​
Autenticação

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

​
Convenções

​
amount
integer
Valores monetários são inteiros em AOA, sem casas decimais (15000 = 15.000 Kz).
​
applicationUUID
string
A tua publishableKey sem o prefixo pk_test_/pk_live_.
​
Accept-Language
header
Idioma das mensagens: pt (default), en, fr.

​
Formato de erros

As respostas de erro seguem este formato: 
{
  "code": 401,
  "message": "Unauthorized",
  "error": "invalid_client"
}
CódigoSignificado
401Token ausente, expirado ou credenciais inválidas.
404Recurso não encontrado.
422Corpo inválido (ex.: amount não-inteiro).

​
Endpoints

POST /token

Obter access token.

POST /createPaymentOrder

Criar ordem de pagamento.

GET /paymentByExternalTransaction

Consultar estado (fallback).

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.