Integrações
Eventos comerciais servidor-a-servidor a partir de checkouts, POS e vendas offline.
Modelo de integração
A AACT é agnóstica ao fornecedor de checkout. O sistema de origem confirma o pagamento e depois envia um evento normalizado com autenticação bearer + HMAC. Business e website vêm da credencial, nunca do payload do cliente.
Endpoint de ingestão HMAC· implementado
Inbox assíncrono / HTTP 202· não suportado
Guias nesta secção
- Narrativa de checkout
Fluxo de ponta a ponta do link de referral ao evento
- Cliente e notifier
Client de assinatura PHP/TypeScript + hook paid
- Eventos
Formas de payload e códigos de resposta
- Autenticação
Bearer token e assinatura HMAC
- Idempotência e retries
external_event_id, nonce, comportamento de replay
- Reembolsos e chargebacks
Reversões proporcionais
Exemplos no repositório
- examples/node-checkout — post-sale.mjs e post-refund.mjs
- examples/offline-sale — helper de venda offline / POS
- docs/integrations/external-hook.md — env de origem, timing do hook, referência FitForge
Exemplos executáveis· implementado