Eventos comerciais

POST /api/v1/integration/events — payloads de sale, refund e chargeback.

Endpoint

POST /api/v1/integration/events no gateway same-origin (local omissão http://localhost:18080).

Resultado	HTTP
Evento novo processado	201 Created
Replay idempotente do mesmo external_event_id	200 OK com replayed: true
Falhas de auth / validação / regras	401 / 422 / etc. conforme contrato

Respostas síncronas 200/201· implementado

HTTP 202 Accepted assíncrono· não suportado

Body de sale

json

{
  "external_event_id": "ord-1001",
  "event_type": "sale",
  "occurred_at": "2026-11-10T12:00:00Z",
  "amount_minor": 10000,
  "currency": "EUR",
  "referral_code": "REF-DEMOCODE01",
  "metadata": { "channel": "node_checkout" }
}

Montantes são inteiros em minor units. A moeda tem de coincidir com o business. referral_code é necessário para atribuição quando espera comissão.

Dinheiro e tempo

amount_minor: inteiro ≥ 1 (sem floats)
currency: código ISO igual ao do business
occurred_at: timestamp ISO-8601 usado na validade das regras