Webhook para confirmação de pagamento de boleto hibrido

O webhook enviado para confirmação de pagamento de boleto hibrido depende exclusivamente do método de pagamento.

Pagamento por pix

Corpo do Webhook

CampoTipoDescrição
identifierUUIDIdentificador da transação
originStringOrigem da transação. Ver tabela de origem para detalhes.
descriptionStringDescrição da transação (Campo aberto para o usuário)
accountIdentifierUUIDIdentificador da conta
typeEnumTipo da transação (RCVD/SENT). Ver tabela de tipo para detalhes.
transactionDateDateTimeData e hora da transação
senderObjectDados do remetente
└── ispbStringISPB do remetente
└── institutionStringInstituição do remetente
└── nameStringNome do remetente
└── documentNumberStringNúmero do documento do remetente
└── branchStringAgência do remetente
└── numberStringNúmero da conta do remetente
└── typeEnumTipo da conta recebedora. Ver tabela de tipos de conta para detalhes.
transactionIdentifierStringTxId do QR code
originalEndToEndStringEnd-to-end de origem da transação em caso de devolução
recipientObjectDados do recebedor
└── ispbStringISPB do recebedor
└── institutionStringInstituição do recebedor
└── nameStringNome do recebedor
└── documentNumberStringNúmero do documento do recebedor
└── branchStringAgência da conta recebedora
└── numberStringNúmero da conta recebedora
└── typeEnumTipo da conta recebedora. Ver tabela de tipos de conta para detalhes.
endToEndStringEnd-to-end da transação
valuedoubleValor da transação
statusEnumStatus do pagamento. Ver tabela de estado para detalhes.

Descrição dos estados do pagamento

StatusDescrição
PAIDPagamento realizado com sucesso
SCHEDULEDAgendamento solicitado com sucesso
PENDINGSolicitação do pagamento está pendente
CANCELEDO pagamento foi cancelado
REQUESTEDSolicitação do pagamento realizada
RETURNEDO pagamento foi devolvido em sua totalidade
REJECTEDPagamento foi rejeitado
ERRORHouve erro na solicitação do pagamento

Descrição dos tipos do pagamento

StatusDescrição
RCVDA ordem de pagamento foi recebida pela conta
SENTA ordem de pagamento foi enviada pela conta

Descrição das origens de ordens de pagamento

StatusDescrição
QR_CODEOrdem de pagamento originada por um QR Code
KEYOrdem de pagamento originada por chave
BANK_ADDRESSOrdem de pagamento originada por dados bancários
REFUNDOrdem de pagamento originada por uma devolução

Exemplo da notificação webhook em JSON:

{
  "identifier": "6db2f724-e022-4fb9-8bf4-44887624029e",
  "origin": "BANK_ADDRESS",
  "description": "description_92cdbae68306",
  "accountIdentifier": "0b00d8dd-edd4-4767-aa56-e32431877585",
  "type": "type_f75af0d7f7fd",
  "transactionDate": "2025-10-28 10:38:02",
  "sender": {
    "ispb": "ispb_4072e5b59b40",
    "institution": "institution_63ca4c9561f1",
    "name": "name_2259a253eb8e",
    "documentNumber": "documentNumber_adc0aa931fe5",
    "branch": "branch_d63430fc3f0d",
    "number": "number_7b2c8c841b1e",
    "type": "CHECKING",
    "key": "key_2f281bbffb56"
  },
  "transactionIdentifier": "transactionIdentifier_62b692cb21ec",
  "originalEndToEnd": "originalEndToEnd_6e91aca2ae1c",
  "recipient": {
    "ispb": "ispb_735444b42ee6",
    "institution": "institution_8a1aba835eac",
    "name": "name_c1dd4845982e",
    "documentNumber": "documentNumber_9d0fae8b6499",
    "branch": "branch_a39f49f8b17c",
    "number": "number_533f092fdeca",
    "type": "CHECKING",
    "key": "key_7361d13900bb"
  },
  "endToEnd": "endToEnd_e0814a1aac70",
  "value": 0.00,
  "status": "PAID"
}

Pagamento por Boleto

Corpo do webhook

CampoTipoDescrição
identifierStringIdentificador do boleto hibrido
accountIdentifierStringidentificador da conta associada ao boleto hibrido
chargeTypeStringTipo de cobrança
amountNumberValor do boleto hibrido
ourNumberNumberNosso numero
statusEnumStatus do boleto
amountNumberValor do pagamento do boleto
amountSettledNumberValor liquidado do pagamento do boleto
fineAmountNumberValor da multa
interestAmountNumberValor do juros
discountAmountNumberValor do desconto
creationDateDateTimeData da criação do boleto
notificationDateDateTimeData da notificação do pagamento
chargedAmountNumberValor da cobrança
dueDateDateTimeData do final do pagamento
urlNotificationStringUrl de notificação de pagamento
payerObjectDados do pagador
└── nameStringNome do pagador
└── documentNumberStringNumero do documento do pagador

Status possíveis

ValorDescrição
PAIDPago através da rede bancária
WRITE_OFFNão disponível para pagamento
SETTLEDValor liquidado na conta
CANCELEDBoleto Cancelado
OVERDUEBoleto Vencido
OPENBoleto em aberto
REGISTEREDBoleto registrado com sucesso

Exemplo json:

{
  "identifier": "1f8e196f-57b2-44c0-8930-cb2943c70968",
  "accountIdentifier": "b9d4b390-9ebb-447a-ac86-5334ce322a1d",
  "chargeType": "chargeType_4cf66b93499c",
  "ourNumber": 0,
  "status": "NEW",
  "amount": 0.00,
  "amountSettled": 0.00,
  "fineAmount": 0.00,
  "interestAmount": 0.00,
  "discountAmount": 0.00,
  "creationDate": "creationDate_7895a7631e5c",
  "notificationDate": "notificationDate_0ed5d3ab6105",
  "chargedAmount": 0.00,
  "dueDate": "dueDate_b0231f734d19",
  "urlNotification": "urlNotification_0aa92dd4e885",
  "payer": {
    "name": "name_458782e2ffc6",
    "documentNumber": "documentNumber_88296f3ebb4f"
  }
}