| Event Type | Category | Description |
|---|---|---|
| pix_charge_paid | Pix QR Code | Pix payment confirmed |
| pix_charge_expired | Pix QR Code | Pix charge expired without payment |
| pix_charge_rejected | Pix | Pix charge rejected |
| withdrawal_success | Withdrawal | Withdrawal processed successfully |
| withdrawal_failed | Withdrawal | Withdrawal processing failed |
| incoming_refund_success | Refund | Refund received |
| outgoing_refund_success | Refund | Refund sent |
| outgoing_refund_failed | Refund | Refund sending failed |
Eventos
Pix Charge Paid
{
"webhookId": "b02ed5c1-8911-4eec-ab6a-edce15b15a9d",
"webhookStatus": "processing",
"clientId": "01e032b8-6452-4ed9-aca0-483535bca51a",
"externalId": "13e032b8-6452-4ed9-aca0-483535bca80a",
"eventType": "pix_charge_paid",
"pixCharge": {
"pixChargeId": "56b548a5-57e2-417f-9df9-f77ec737f25c",
"expiresAt": "2026-01-15T10:17:30.977004+00:00",
"amountInCents": 79034,
"createdAt": "2026-01-15T10:17:30.977004+00:00",
"paidAt": "2026-01-15T10:17:30.977004+00:00",
"status": "PAID",
"debtor": {
//this is the actual payer
"ispb": "18394228",
"branch": "0001",
"accountNumber": "48000007",
"personType": "NATURAL_PERSON",
"accountType": "CACC",
"cpfCnpj": "05004397023",
"name": "Paola Paulina de Abreu Grassi"
},
"payer": {
// this was sent by you
"cpfCnpj": "15175356623",
"name": "Andre",
"bankAccounts": [
{
"accountNumber": "123456",
"accountType": "CACC",
"branch": "0001",
"ispb": "00000000",
"personType": "NATURAL_PERSON"
}
]
},
"pixTransaction": {
"transactionId": "019bc24a-92cc-79fb-96da-aba7481714a9",
"endToEndId": "E3098053920240115164700397678057"
},
"validation": {
"ensureSameCpfCnpj": true,
"ensureSameBankAccount": true
}
}
}
Pix_Charge_Expired
{
"webhookId": "fb0d8a60-0207-485c-9cba-93c1ed638f76",
"clientId": "b4d7f0aa-a3ca-4a54-8f31-1410249cae18",
"externalId": "03f64f37-19e7-4158-8cc6-8cdb476cabd7",
"eventType": "pix_charge_expired",
"pixCharge": {
"pixChargeId": "019cfe55-6f47-731d-931e-61352bc41bfc",
"expiresAt": "2026-03-18T00:42:17.85857+00:00",
"amountInCents": "1000",
"createdAt": "2026-03-18T00:25:37.85857+00:00",
"status": "EXPIRED",
"payer": {
"cpfCnpj": "39424283008",
"name": "PT1",
"bankAccounts": [
{
"accountNumber": "20262027",
"accountType": "CACC",
"branch": "0001",
"ispb": "00000000",
"personType": "NATURAL_PERSON"
}
]
},
"validation": {
"ensureSameCpfCnpj": true,
"ensureSameBankAccount": true
}
}
}
Pix_charge_rejected
{
"webhookId": "4d484381-c16d-438a-8685-21bdd22be886",
"clientId": "b4d7f0aa-a3ca-4a54-8f31-1410249cae18",
"externalId": "4af5ad4a-549d-463b-9e53-74528f933b3a",
"eventType": "pix_charge_rejected",
"pixCharge": {
"rejectedReason": "ACCOUNT_MISMATCH",
"rejectedDescription": "Conta pagadora não permitida para este QR Code",
"pixChargeId": "019cfe5a-fa40-7378-aa76-e30fd2c5f901",
"expiresAt": "2026-03-18 00:48:21.112139+00",
"amountInCents": 1000,
"createdAt": "2026-03-18 00:31:41.112139+00",
"paidAt": null,
"status": "PENDING",
"debtor": {
"ispb": "00000000",
"branch": "0001",
"accountNumber": "3323200006",
"personType": "NATURAL_PERSON",
"accountType": "CACC",
"cpfCnpj": "39424283008",
"name": "Teste Mock"
},
"payer": {
"cpfCnpj": "39424283008",
"name": "PT1",
"bankAccounts": [
{
"ispb": "00000000",
"branch": "0001",
"accountNumber": "3323200006",
"personType": "NATURAL_PERSON",
"accountType": "CACC"
}
]
},
"validation": {
"ensureSameCpfCnpj": true,
"ensureSameBankAccount": true
}
}
}
Withdrawal_success
{
"webhookId": "b02ed5c1-8911-4eec-ab6a-edce15b15a9d",
"webhookStatus": "processing",
"clientId": "01e032b8-6452-4ed9-aca0-483535bca51a",
"externalId": "13e032b8-6452-4ed9-aca0-483535bca80a",
"eventType": "withdrawal_success",
"withdrawal": {
"transactionId": "56b548a5-57e2-417f-9df9-f77ec737f25c",
"endToEndId": "E3098053920240115164700397678057",
"amountInCents": 79034,
"createdAt": "2026-01-15T10:17:30.977004+00:00",
"settlementDateTime": "2026-01-15T10:17:30.977004+00:00",
"status": "SUCCESS",
"initiationType": "MANUAL",
"receiver": {
"cpfCnpj": "01234567890",
"name": "Andre",
"ispb": "1",
"branch": "up to 4 digits",
"accountNumber": "up to 20 digits",
"personType": "NATURAL_PERSON",
"accountType": "CACC"
},
"validation": {
"ensureSameCpfCnpj": true,
"ensureSameBankAccount": true
}
}
}
Withdrawal_failed
{
"webhookId": "662d8193-d54a-484f-a72d-07d1db550660",
"clientId": "0b127ae8-0f2e-4a9b-aa28-8a4421b92b4c",
"externalId": "4e7c2262-aa19-4544-bc05-f2539b58c684",
"eventType": "withdrawal_failed",
"withdrawal": {
"initiationType": "MANUAL",
"transactionId": "019cda64-57ac-7533-b730-0115000b7d57",
"endToEndId": "E18394228202603110055sPf8krIBjsA",
"amountInCents": 10,
"createdAt": "2026-03-11T00:55:35.166477+00:00",
"settlementDateTime": "2026-03-11T00:55:35.166477+00:00",
"status": "FAILED",
"receiver": {
"cpfCnpj": "91256956813",
"name": "teste",
"ispb": "00000000",
"branch": "4364",
"accountNumber": "152650",
"personType": "NATURAL_PERSON",
"accountType": "CACC"
},
"validation": {
"ensureSameCpfCnpj": true,
"ensureSameBankAccount": true
},
"errorReason": "AC14",
"errorDescription": "Incorrect type for the recipient user's transactional account."
}
}
outgoing_refund_success
{
"webhookId":"b02ed5c1-8911-4eec-ab6a-edce15b15a9d",
"webhookStatus":"processing",
"clientId":"01e032b8-6452-4ed9-aca0-483535bca51a",
"externalId":"13e032b8-6452-4ed9-aca0-483535bca80a",
"eventType":"outgoing_refund_success",
"refund":{
"transactionId":"56b548a5-57e2-417f-9df9-f77ec737f25c",
"endToEndId":"D3098053920240115164700397678057",
"orginalEndToEndId":"D3098053920240115164700397678057",
"amountInCents":1,
"createdAt":"2026-01-15T10:17:30.977004+00:00",
"settlementDateTime":"2026-01-15T10:17:30.977004+00:00",
"status":"success",
"receiver":{
"cpfCnpj":"01234567890",
"name":"Andre",
"ispb":"1",
"branch":"up to 4 digits",
"accountNumber":"up to 20 digits",
"personType":"NATURAL_PERSON",
"accountType":"CACC"
},
"leftAmountInCents":0,
"originalAmountInCents":1
}
}
outgoing_refund_failed
{
"webhookId":"b02ed5c1-8911-4eec-ab6a-edce15b15a9d",
"webhookStatus":"processing",
"clientId":"01e032b8-6452-4ed9-aca0-483535bca51a",
"externalId":"13e032b8-6452-4ed9-aca0-483535bca80a",
"eventType":"outgoing_refund_failed",
"refund":{
"transactionId":"56b548a5-57e2-417f-9df9-f77ec737f25c",
"endToEndId":"D3098053920240115164700397678057",
"orginalEndToEndId":"D3098053920240115164700397678057",
"amountInCents":1,
"createdAt":"2026-01-15T10:17:30.977004+00:00",
"status":"FAILED",
"receiver":{
"cpfCnpj":"01234567890",
"name":"Andre",
"ispb":"1",
"branch":"up to 4 digits",
"accountNumber":"up to 20 digits",
"personType":"NATURAL_PERSON",
"accountType":"CACC"
},
"leftAmountInCents":0,
"originalAmountInCents":1,
"errorReason":"AC14",
"errorDescription":"Incorrect type for the recipient user's transactional account."
}
}