Cobrança criada

Categoria: Cobrança
Evento: Cobrança criada

Nome do Evento

BILLING_CREATED

Disparado imediatamente após a geração com sucesso de um título de cobrança Pix dinâmico (POST /credit-operations/{externalContractId}/billings).

Estrutura do Payload

{
  "eventType": "BILLING_CREATED",
  "entityId": "a1b2c3d4-e5f6-7890-abcd-ef1234567890",
  "occurredAt": "2026-09-28T10:00:00Z",
  "data": {
    "externalContractId": "CONTRATO-2026-001",
    "billing": {
      "externalId": "bill-e4f5a6b7-c8d9-0123-ef45-678901234567",
      "type": "PIX",
      "status": "OPEN",
      "dueDate": "2026-10-15T00:00:00Z",
      "chargedValue": 350.50,
      "paidAmount": null,
      "paidAt": null,
      "pixInfo": {
        "identifier": "txid-pix-001",
        "emv": "00020126580014br.gov.bcb.pix2536pix-qr.openco.com/qr/v2/cob/...",
        "imageBase64": "iVBORw0KGgoAAAANSUhEUgAA...",
        "expirationDate": "2026-10-15T23:59:59Z"
      }
    }
  }
}

Tabela de Descrição dos Campos

Campo	Tipo	Descrição
`externalContractId`	string	Identificador único do contrato no parceiro.
`billing.externalId`	string	Identificador do título de cobrança gerado no provedor de pagamentos.
`billing.type`	string	Tipo da cobrança (`PIX`).
`billing.status`	string	Status atual da cobrança (`OPEN`).
`billing.dueDate`	datetime	Data de vencimento da cobrança (UTC).
`billing.chargedValue`	decimal	Valor cobrado em reais (BRL).
`billing.pixInfo.emv`	string	Linha digitável Pix Copia e Cola.
`billing.pixInfo.imageBase64`	string	Imagem do QR Code em Base64 para exibição na tela do cliente.
`billing.pixInfo.expirationDate`	datetime	Data e hora de expiração do QR Code.