Skip to main content
A integração Pix Direto via JD emite 21 fatos de negócio em JSON como CloudEvents 1.0 no modo de conteúdo binário sobre Kafka. O streaming é opcional. Quando habilitado, a integração grava o estado de negócio e o envelope do evento no outbox do PostgreSQL na mesma transação; o relay do outbox é o único publicador no broker.

Contrato de transporte

Configure STREAMING_ENABLED=true e OUTBOX_ENABLED=true juntos. Se você definir STREAMING_CLOUDEVENTS_SOURCE, o valor deve ser exatamente plugin-br-pix-jd. Quando o streaming está desabilitado, a integração não grava eventos de ciclo de vida no outbox de streaming.
Esta integração ainda não expõe um endpoint de manifesto de streaming. O catálogo do bootstrap contém apenas a definição estrutural transaction.created, enquanto os caminhos de emissão em produção publicam os 21 fatos abaixo. Use esta página—e não o catálogo incompleto do runtime—como o inventário atual de eventos.
Faça a deduplicação por (ce-source, ce-id) e mantenha os consumidores idempotentes. A integração não provisiona um tópico de comandos.

Catálogo de eventos

Cada ce-type usa studio.lerian.plugin-br-pix-jd.<event-key>.

Transações

Chaves e reivindicações DICT

Autorizações do Pix Automático

Agendamentos do Pix Automático

Contratos de payload

Todos os timestamps são strings RFC 3339 em UTC. Os valores monetários de transações e Pix Automático são centavos inteiros, não strings decimais nem números de ponto flutuante. Os campos marcados com ? podem ser omitidos.
O contrato no wire codifica amount, value e payerMaxValue como tokens numéricos JSON int64. Consumidores JavaScript que aceitam todo o intervalo de int64 devem usar um parser JSON sem perda e compatível com BigInt ou rejeitar valores acima de Number.MAX_SAFE_INTEGER; o JSON.parse pode arredondar inteiros maiores.