Documentação AACT
Atribuição e liquidação de comissões self-hosted para vários businesses.
O que a AACT faz
A AACommissionTool (AACT - Agnostically-Assigning-a-Comission Tool) recebe eventos comerciais de sistemas externos, atribui vendas a referrers, aplica regras de comissão versionadas, mantém um ledger append-only em unidades menores e ajuda operadores a rever pedidos de payout. Os pagamentos são registados depois de executados fora da plataforma.
- Admin configura businesses, websites, regras e credenciais de integração
- Referrers fazem onboarding com dados de pagamento e documentos, depois recebem códigos
- Checkouts/POS externos enviam eventos autenticados de sale, refund e chargeback
- O portal mostra comissões, saldos available/reserved/payable e pedidos de payout
Fluxos principais do produto· implementado
O que a AACT não faz
- Não é um sistema de faturação certificado nem de submissão fiscal
- Não é um PSP e não trata PAN/CVV
- Não reivindica certificação RGPD nem entrega “exactly-once” na rede
Rails bancários / certificação fiscal· não suportado
Maturidade
As fases 0–5 do slice de portefólio estão implementadas para uso local e demo. Deployments de produção são da responsabilidade do operador: TLS, TOTP de admin, proxies de confiança e rotação de segredos devem ser configurados de propósito.
Portefólio local/demo· implementado
Empacotamento SaaS de produção· planeado
Glossário
| Termo | Significado |
|---|---|
| Business | Tenant comercial com moeda e limiar de payout |
| Website | Canal/loja sob um business |
| Source | Id estável do canal de integração na idempotência de eventos |
| Credencial de integração | Bearer + HMAC ligados a business, website e source |
| Referrer | Membro aprovado que recebe comissões |
| Referral code | Código enviado como referral_code nos eventos de sale |
| Event | Payload normalizado de sale, refund ou chargeback |
| Commission | Montante atribuído com snapshot da regra em minor units |
| Payable | Saldo do ledger na conta payable do referrer |
| Reserved | Soma dos pedidos de payout pending/approved |
| Available | Payable menos reserved |
| Payout | Pedido para liquidar saldo available externamente |
Seguinte
- Começar
Setup Compose local e primeiro fluxo demo
- Integração checkout
Como vendas pagas se tornam eventos de comissão
- Referência API
Superfície OpenAPI curada