Eventos do Pix Direct via JD

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

Contrato de transporte

Campo	Valor
`ce-source`	`plugin-br-pix-jd`
Tópico	`lerian.streaming.plugin-br-pix-jd`
Versão do schema	`1.0.0` para todo evento
Tipo de conteúdo	`application/json`
Entrega	Pelo menos uma vez, por meio do outbox transacional
Tópico de comandos	Nenhum
Manifesto em runtime	Não exposto

Defina STREAMING_ENABLED=true e OUTBOX_ENABLED=true juntos. Se você definir STREAMING_CLOUDEVENTS_SOURCE, o valor dele deve ser exatamente plugin-br-pix-jd. Quando o streaming está desligado, a integração não escreve eventos de ciclo de vida no outbox de streaming.

Esta integração ainda não expõe um endpoint de manifesto de streaming. Seu catálogo de bootstrap contém apenas a definição estrutural de transaction.created, enquanto os caminhos de emissão em produção abaixo publicam todos os 21 fatos. Use esta página como o inventário atual de eventos, não o catálogo incompleto em runtime.

Deduplique por (ce-source, ce-id) e mantenha os consumidores idempotentes. A integração não provisiona nenhum tópico de comandos.

Catálogo de eventos

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

Transações

Chave do evento	Dispara quando
`transaction.created`	Um cash-out externo é persistido como pendente, seu lançamento pendente no Midaz existe, e o envio ao JDPI é bem-sucedido.
`transaction.executed`	Uma transferência interna é concluída de forma síncrona, um cash-in é aplicado, ou a conciliação liquida um cash-out externo.
`transaction.refunded`	Uma transação de devolução é persistida e vinculada à transação original.
`transaction.failed`	A conciliação move um cash-out externo pendente para seu estado terminal de erro e cancela o lançamento pendente.

Chaves DICT e reivindicações

Chave do evento	Dispara quando
`key.registered`	Uma chave é registrada no DICT e persistida como ativa.
`key.validation-requested`	A integração armazena e envia um desafio de validação de posse.
`key.confirmed`	O desafio enviado é verificado e a chave sai do estado de aguardando confirmação.
`key.deleted`	Uma chave é excluída no DICT e recebe soft delete localmente.
`key.claimed`	Uma reivindicação é aberta no DICT e seu identificador é persistido.
`key.claim-confirmed`	O doador confirma a reivindicação.
`key.claim-concluded`	O reivindicante conclui a reivindicação.
`key.claim-cancelled`	A reivindicação é cancelada.

Autorizações do Pix Automático

Chave do evento	Dispara quando
`authorization.requested`	O PSP recebedor solicita uma autorização e a integração a persiste como solicitada.
`authorization.accepted`	O pagador aceita a autorização.
`authorization.rejected`	A autorização transita para rejeitada.
`authorization.activated`	A autorização é confirmada com sucesso e transita para ativa.
`authorization.cancelled`	A autorização é cancelada e recebe soft delete.

Agendamentos do Pix Automático

Chave do evento	Dispara quando
`schedule.requested`	O PSP recebedor solicita um agendamento de pagamento e a integração o persiste como solicitado.
`schedule.accepted`	O agendamento transita para aceito.
`schedule.rejected`	O agendamento transita para rejeitado.
`schedule.cancelled`	O agendamento é cancelado e recebe soft delete.

Contratos de payload

Todos os timestamps são strings RFC 3339 em UTC. Os valores monetários de transação e Pix Automático são centavos inteiros, não strings decimais nem números de ponto flutuante. Os campos marcados com ? são opcionais.

O contrato de wire codifica amount, value e payerMaxValue como tokens numéricos int64 em JSON. Consumidores JavaScript que aceitam o intervalo completo de int64 devem usar um parsing de JSON sem perdas e compatível com BigInt, ou rejeitar valores acima de Number.MAX_SAFE_INTEGER. O JSON.parse padrão pode arredondar inteiros maiores.

interface TransactionEventData {
  id: string
  jdpiRequestId?: string
  indirectId?: string
  endToEndId?: string
  status: string
  flow: number
  type: number
  amount: number // int64 centavos
  accountId: string
  isRefund: boolean
  isInternal: boolean
  refundType?: number
  refundAccountId?: string
  refundEndToEndId?: string
  refundCode?: string
  createdAt: string
  updatedAt: string
}

interface KeyEventData {
  id: string
  key: string
  accountId: string
  status: number
  keyType: number
  claimId?: string
  claimType?: number
  createdAt: string
  updatedAt: string
}

interface AuthorizationEventData {
  id: string
  idRecorrencia: string
  idReqJdPi?: string
  idCancelamento?: string
  tenantId?: string
  status: number
  frequency: number
  value?: number // int64 centavos
  payerMaxValue?: number // int64 centavos
  recipientIspb?: string
  recipientCnpj?: string
  payerCpfCnpj?: string
  contractNumber?: string
  createdAt: string
  updatedAt: string
}

interface ScheduleEventData {
  id: string
  endToEndId: string
  idRecorrencia: string
  idConciliacaoRecebedor?: string
  idCancelamento?: string
  tenantId?: string
  status: number
  finalidadeAgendamento: number
  dtVencimento?: string
  value?: number // int64 centavos
  recipientIspb?: string
  recipientCnpj?: string
  payerCpfCnpj?: string
  createdAt: string
  updatedAt: string
}

APIs do participante direto

APIs de participantes indiretos

Eventos do Pix Direct via JD

Contrato de transporte

Catálogo de eventos

Transações

Chaves DICT e reivindicações

Autorizações do Pix Automático

Agendamentos do Pix Automático

Contratos de payload

​Contrato de transporte

​Catálogo de eventos

​Transações

​Chaves DICT e reivindicações

​Autorizações do Pix Automático

​Agendamentos do Pix Automático

​Contratos de payload

Contrato de transporte

Catálogo de eventos

Transações

Chaves DICT e reivindicações

Autorizações do Pix Automático

Agendamentos do Pix Automático

Contratos de payload