Modelo Webhook

Webhook de recebimento pix cash in

Entity: pix-payment-in

{
  "createTimeStamp": "2026-02-04T11:54:27.2743201",
  "body": {
    "amount": 194,
    "debitParty": {
      "bank": "13935893",
      "taxId": "33735789000188",
      "accountType": "CACC",
      "name": "IS2B Integrated Solutions to Business SA",
      "branch": "0030",
      "account": "3794245"
    },
    "currentBalance": 34883926.35,
    "endToEndId": "E139358932026020414547uzUUCPfto4",
    "paymentType": "IMMEDIATE",
    "initiationType": "DICT",
    "transactionType": "RECEIVEPIX",
    "urgency": "HIGH",
    "remittanceInformation": "",
    "oldBalance": 34883732.35,
    "id": "37ae14d3-9812-4f57-8e83-796cc6e211da",
    "creditParty": {
      "bank": "13935893",
      "taxId": "77517432125",
      "accountType": "TRAN",
      "name": "Margaret Gusikowski",
      "branch": "0001",
      "key": "77517432125",
      "account": "30023646094934"
    },
    "transactionIdentification": ""
  },
  "entity": "pix-payment-in",
  "status": "CONFIRMED"

Tabela de apoio

Campo	Descrição
createTimeStamp	Detalhamento de data e hora do recebimento do Pix
amount	Valor do recebimento
oldBalance	Saldo anterior
currentBalance	Saldo atual
debitParty	Dados do pagador
bank	ISPB do banco do pagador
taxId	CPF/CNPJ do pagador
name	Nome do pagador
branch	Agência do banco do pagador
account	Número da conta do pagador
accountType	Tipo de conta
id	identificador do recebimento
endToEndId	Identificador ponta-a-ponta associado ao pagamento.
creditParty	Dados do creditado
bank	ISPB do banco creditado
taxId	CPF/CNPJ do creditado
name	Nome de quem será creditado
branch	Agência do creditado
account	Número da conta do creditado
accountType	Tipo da conta
initiationType	Tipo de iniciação do pagamento (MANUAL, DICT, STATIC_QRCODE, DYMANIC_QRCODE)
transactionType	Tipo da transação Pix
urgency	Determina a urgência do pagamento
paymentType	Tipo de pagamento definido na transação (IMMEDIATE, FRAUD, SCHEDULED). IMMEDIATE: Usado para pagamentos imediatos. FRAUD: Usado para pagamento por suspeita de fraude. SCHEDULED: Usado apenas para pagamentos agendados.

Webhook de devolução de pix cash in

entity: pix-reversal-out

{
  "body": {
    "reason": "MD06",
    "additionalInformation": "",
    "amount": 40,
    "debitParty": {
      "bank": "4545",
      "taxId": "5454",
      "accountType": "TRAN",
      "name": "454",
      "branch": "0001",
      "account": "4550454545500"
    },
    "clientCode": "34b2316e-0962-466f-45554b3a7-8173da19a0a0",
    "originalPaymentId": "fe965888-c7ee-45454-8896-b14af3758e7d",
    "currentBalance": 2132949.29,
    "oldBalance": 2132830.79,
    "returnIdentification": "4545454",
    "id": "fe965888-c7ee-41d7-8896-454554",
    "creditParty": {
      "bank": "454",
      "taxId": "454",
      "accountType": "TRAN",
      "name": " Lima",
      "branch": "0001",
      "account": "454545"
    },
    "originalEndToEndId": "454545454"
  },
  "entity": "pix-reversal-out",
  "createTimestamp": "2026-02-05T13:40:55.6788811+00:00",
  "status": "CONFIRMED"
}

Tabela de apoio


amount	Valor
oldBalance	Saldo anterior
currentBalance	Saldo atual
id	Identificador da transação do recebimento pix
clientCode	Código do cliente
reason	Razão da Devolução, podendo ser: BE08: Devolvido como resultado de um erro bancário. FR01: Devolução por suspeita de fraude. MD06: Devolução solicitada pelo cliente final. SL02: Devolução do valor em dinheiro devido a um erro relacionado ao Pix Saque ou Pix Troco.
returnIdentification	Identificação do retorno
originalEndToEndId	EndtoEnd id da transação recebida, que é o pix que você deseja devolver
originalPaymentId	Id do pagamento

Webhook QR code expirado

Entity: pix-qrcode-expired

{
        "body": {
            "status": "EXPIRED",
            "transactionId": "4000405507",
            "payerQuestion": "Pagar ate a data de vencimento",
            "additionalInformation": null,
            "debtor": {
                "name": "MARIA IRANDI DOS SANTOS",
                "city": null,
                "publicArea": null,
                "state": null,
                "postalCode": null,
                "email": null,
                "txId": "06856109342",
                "fantasyName": null
            },
            "key": "c07a4e09-11a4-4df7-8f47-1055baffdd77",
            "receiver": {
                "name": "Primepag Solucoes em Pag",
                "city": "SAO PAULO",
                "publicArea": null,
                "state": null,
                "postalCode": "04543011",
                "email": null,
                "txId": null,
                "fantasyName": null
            },
            "amount": {
                "original": 20,
                "changeType": null,
                "withdrawal": null,
                "change": null,
                "discount": null,
                "abatement": null,
                "fine": null,
                "interest": null
            },
            "calendar": {
                "expirationAfterPayment": 0,
                "expiration": 1800,
                "createdAt": "2025-09-15T11:19:41.611Z",
                "dueDate": "2025-09-15T11:49:41.611Z",
                "expirationDate": "2025-09-15T14:49:41.611Z"
            },
            "clientRequestId": null,
            "transactionIdentification": "kk6g232xel65a0daee4dd13kk4000405507",
            "updateAt": null,
            "merchant": {
                "postalCode": "04543011",
                "city": "SAO PAULO",
                "merchantCategoryCode": 0,
                "name": "Primepag Solucoes em Pag"
            },
            "url": "qrcode-h.pix.celcoin.com.br/pixqrcode/v2/aedf0b1099b2edd52935c8626e6a9d",
            "emv": "00020101021226930014br.gov.bcb.pix2571qrcode-h.pix.celcoin.com.br/pixqrcode/v2/aedf0b1099b2edd52935c8626e6a9d5204000053039865802BR5924Primepag Solucoes em Pag6009SAO PAULO62070503***6304C5AC",
            "type": "COB",
            "recurrency": null
        },
        "entity": "pix-qrcode-expired",
        "createTimestamp": "2025-05-07T17:58:00.9251466",
        "status": "EXPIRED"
    }