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

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"
    }