Repositório comunitário para reunir informação prática sobre gateways de pagamento, agregadores, bancos, *mobile money*, POS/TPA, e **pagamentos por referência** usados em Angola. Objetivo: facilitar a vida de quem quer começar rápido, com fontes, contactos, requisitos e dicas técnicas/legais.
# Angola Online Payment Gateway
Repositório comunitário para **reunir informação prática** sobre gateways de pagamento, agregadores, bancos, *mobile money*, POS/TPA, e **pagamentos por referência** usados em Angola. Objetivo: facilitar a vida de quem quer **começar rápido**, com fontes, contactos, requisitos e dicas técnicas/legais.
> ⚠️ **Estado**: Este repositório **esta em desenvolvimento**.
> ⚠️ **Aviso legal**: Este projeto é colaborativo e **não** representa, nem é afiliado, patrocinado, endossado ou associado a quaisquer marcas, bancos, operadoras, gateways, agregadores ou entidades citadas.
Nomes e logótipos mencionados são propriedade dos seus titulares.
As informações aqui reunidas podem ficar **desatualizadas**. Verifica sempre as **fontes oficiais** antes de decisões técnicas ou comerciais.
Este material é fornecido “**AS IS**”, sem garantias. **Não** constitui aconselhamento jurídico, financeiro ou fiscal.
## O que vais encontrar
- 📚 **Catálogo de fornecedores**: `data/providers/*.yml` (produtos, integrações, links de doc, prazos de liquidação, taxas quando públicas, etc.)
- 🧭 **Guia de onboarding**: passos típicos (KYC/AML, contratos, testes, produção).
- ✅ **Checklist por fornecedor** (`docs/checklist-provider.md`)
- 🧩 **Esquema dos dados**: `data/schema.json` para validar entradas.
- 🔌 **Exemplos HTTP**: como pedir referências, webhooks, etc. em `examples/http`.
## Estrutura dos dados
Cada fornecedor é um `.yml` em `data/providers/` que segue o `data/schema.json`.
Exemplo rápido:
```yaml
# data/providers/exemplo-appx.yml
id: appx
nome: "AppX Pagamentos"
categoria: "agregador" # ver data/categories.yml
canais:
- referencia # referencia/QR/pos/ecommerce/mobile_money
- ecommerce
produtos:
- "Pagamentos por referência"
- "Checkout e-commerce"
documentacao:
site: "
exemplo.appx.ao"
docs_api: "
exemplo.appx.ao"
portal_merchant: "
exemplo.appx.ao"
integracao:
autenticacao: "API Key"
webhooks: t …