Webhooks Med 2.0

Webhooks

Esta seção tem como objetivo apresentar os eventos de webhook disponíveis para integração no contexto do MED 2.0, permitindo que o cliente Celcoin acompanhe, a evolução dos processos de recuperação de valores relacionados a transações Pix.

Por meio do cadastro e consumo desses webhooks, será possível receber notificações automáticas sobre os principais eventos do fluxo.

Notificações para acompanhar as solicitações de recuperação de valores

Eventos	Status	Descrição
pix-funds-recovery-awaiting-analysis	AWAITING_ANALYSIS	Recuperação de valores gerada, em análise pelos participantes recebedores em andamento.
pix-funds-recovery-analysed	ANALYSED	Recuperação e valores analisadas e fechadas.
pix-funds-recovery-completed	COMPLETED	Recuperação de valores finalizada.
pix-funds-recovery-cancelled	CANCELLED	Recuperação de valores cancelada.

Exemplos de webhook

Evento: pix-funds-recovery-awaiting-analysis

{
		"lastUpdateTimestamp": "0001-01-01T00:00:00",
		"webhookId": "infraction-CLOSED-9eedec74-dcb5-42e3-b9b4-55536f589334",
		"body":{
			"fundsRecoveryId": "ca1b9c01-ff9e-4a58-90ab-d31512e15ce0",
			"status": "ANALYSIS",
			"flowType": "AUTOMATED",
			"rootEndToEnd": "E9999901012341234123412345678900",
			"situationType": "SCAM",
			"reportDetails": "Transação feita através de QR Code falso em boleto",
			"contactInformation": {
				"email": "[email protected]",
				"phone": "+5561988887777"
			},
			"creationTime": "2020-01-17T10:00:00.000Z",
			"lastModified": "2020-01-17T10:00:00.000Z"
		},
		"entity": "pix-funds-recovery-awaiting-analysis",
		"createTimestamp": "0001-01-01T00:00:00",
		"status": "ANALYSIS"
	}

Evento: pix-funds-recovery-analysed

{
		"lastUpdateTimestamp": "0001-01-01T00:00:00",
		"webhookId": "infraction-CLOSED-9eedec74-dcb5-42e3-b9b4-55536f589334",
		"body":{
			"fundsRecoveryId": "ca1b9c01-ff9e-4a58-90ab-d31512e15ce0",
			"status": "ANALYSED",
			"flowType": "AUTOMATED",
			"rootEndToEnd": "E9999901012341234123412345678900",
			"situationType": "SCAM",
			"reportDetails": "Transação feita através de QR Code falso em boleto",
			"contactInformation": {
				"email": "[email protected]",
				"phone": "+5561988887777"
			},
			"creationTime": "2020-01-17T10:00:00.000Z",
			"lastModified": "2020-01-17T10:00:00.000Z"
		},
		"entity": "pix-funds-recovery-analysed",
		"createTimestamp": "0001-01-01T00:00:00",
		"status": "COMPLETED"
	}

Evento: pix-funds-recovery-completed

{
		"lastUpdateTimestamp": "0001-01-01T00:00:00",
		"webhookId": "infraction-CLOSED-9eedec74-dcb5-42e3-b9b4-55536f589334",
		"body":{
			"fundsRecoveryId": "ca1b9c01-ff9e-4a58-90ab-d31512e15ce0",
			"status": "COMPLETED",
			"flowType": "AUTOMATED",
			"rootEndToEnd": "E9999901012341234123412345678900",
			"situationType": "SCAM",
			"reportDetails": "Transação feita através de QR Code falso em boleto",
			"contactInformation": {
				"email": "[email protected]",
				"phone": "+5561988887777"
			},
			"creationTime": "2020-01-17T10:00:00.000Z",
			"lastModified": "2020-01-17T10:00:00.000Z"
		},
		"entity": "pix-funds-recovery-completed",
		"createTimestamp": "0001-01-01T00:00:00",
		"status": "COMPLETED"
	}

Evento: pix-funds-recovery-cancelled

{
		"lastUpdateTimestamp": "0001-01-01T00:00:00",
		"webhookId": "infraction-CLOSED-9eedec74-dcb5-42e3-b9b4-55536f589334",
		"body":{
			"fundsRecoveryId": "ca1b9c01-ff9e-4a58-90ab-d31512e15ce0",
			"status": "CANCELLED",
			"flowType": "AUTOMATED",
			"rootEndToEnd": "E9999901012341234123412345678900",
			"situationType": "SCAM",
			"reportDetails": "Transação feita através de QR Code falso em boleto",
			"contactInformation": {
				"email": "[email protected]",
				"phone": "+5561988887777"
			},
			"creationTime": "2020-01-17T10:00:00.000Z",
			"lastModified": "2020-01-17T10:00:00.000Z"
		},
		"entity": "pix-funds-recovery-cancelled",
		"createTimestamp": "0001-01-01T00:00:00",
		"status": "CANCELLED"
	}

Notificações para receber, responder e acompanhar o resultado ou cancelamento de uma solicitação de recuperação de valores aberta.

Eventos	Status	Descrição
pix-infraction	ACKNOWLEDGED	Status inicial de recebimento da solicitação de recuperação de valores
pix-infractioN	OPEN	Status que indica que a recuperação de valores está aberta.
pix-infraction	CLOSED	Recuperação de valores encerrada pela IF contestante . Ela poderá ser Rejeitada (DISAGREED) ou Aceita (AGREED)
pix-infraction	CANCELLED	Recuperação de valores cancelada pela IF contestante.

Exemplos de webhook

Evento: pix-infraction - ACKNOWLEDGED

{
	"lastUpdateTimestamp": "2026-04-17T03:54:03.187",
    "pactualId": "01000000-7058-cb1d-35af-08de9c4e1bac",
	"clientRequestId": "",
	"body": {
		"infractionType": "REFUND_REQUEST",
		"creationTime": "2026-04-17T09:03:22.697",
		"reportDetails": "Golpe/Estelionato",
		"responseTime": "2026-04-17T03:54:03.187",
		"endToEndId": "E22896431202604170653yPMGaQXkSxK",
		"reportedBy": "DEBITED_PARTICIPANT",
		"infractionData": {
			"taxIdNumber": "30247128000115",
			"infractingAccountData": {
				"accountNumber": "30053611718",
				"branch": 1
			},
			"debitedParticipant": "22896431",
			"reportedBy": "DEBITED_PARTICIPANT",
			"transactionDate": "2026-04-17T03:54:03.187",
			"creditedParticipant": "13935893",
			"key": "eccc43f3-5210-4634-af39-86cd0e3b3528"
		},
		"transactionId": "E22896431202604170653yPMGaQXkSxK",
		"creditedParticipant": "13935893",
		"transactionType": "TRANSFER",
		"id": "3e69f867-96e3-4c6a-b500-37fe930c35e3",
		"debitedParticipant": "22896431",
		"lastModified": "2026-04-17T09:03:32.617",
		"status": "ACKNOWLEDGED"
	},
	"entity": "pix-infraction",
	"transactionId": 202604170000113120,
	"createTimestamp": "2026-04-17T03:54:03.187",
	"status": "ACKNOWLEDGED"
}

Evento: pix-infraction - OPEN

{
	"tenantId": "**PRIVATE**",
	"body": {
	"lastUpdateTimestamp": "2026-04-03T20:26:49.237",
	"pactualId": "01000000-534d-774a-f55e-08de91d87a24",
	"clientRequestId": "",
	"body": {
		"infractionType": "REFUND_REQUEST",
		"creationTime": "2026-04-16T17:54:31.147",
		"reportDetails": "Solicitamos a abertura de MED por fraude em transações realizadas por meio de nossa plataforma. Requeremos, nos termos da regulamentação aplicável, a indisponibilidade cautelar dos valores nas contas de destino e a devolução.",
		"responseTime": "2026-04-03T20:26:49.237",
		"endToEndId": "E339829182026040323268FH8ASOG15L",
		"reportedBy": "DEBITED_PARTICIPANT",
		"infractionData": {
			"taxIdNumber": "42187428800",
			"infractingAccountData": {
				"accountNumber": "423441443",
				"branch": 1
			},
			"debitedParticipant": "33982918",
			"reportedBy": "DEBITED_PARTICIPANT",
			"transactionDate": "2026-04-03T20:26:49.237",
			"creditedParticipant": "13935893",
			"key": "42187428800"
		},
		"transactionId": "E339829182026040323268FH8ASOG15L",
		"creditedParticipant": "13935893",
		"transactionType": "TRANSFER",
		"id": "6c63ce37-9581-400b-922d-4fb4a05bd4ce",
		"debitedParticipant": "33982918",
		"lastModified": "2026-04-16T17:54:31.147",
		"status": "OPEN"
	},
	"entity": "pix-infraction",
	"transactionId": 202604030000911300,
	"createTimestamp": "2026-04-03T20:26:49.237",
	"status": "OPEN"
},
	"entity": "pix-infraction"
}

Evento: pix-infraction - CLOSED / analysisResult: "DISAGREED" (Rejeitada)

{
	"lastUpdateTimestamp": "0001-01-01T00:00:00",
	"webhookId": "infraction-CLOSED-96f2a8e0-8ee4-40f1-806d-49a7d818afb1",
	"body": {
		"analysisDetails": "Em contato com o cliente, não foi identificado fraude.",
		"infractionType": "REFUND_REQUEST",
		"creationTime": "2026-04-17T00:31:25.908+00:00",
		"reportDetails": "Usuário pagador contestou a transação via fluxo formal previsto pelo MED. Favor avaliar se há indícios de fraude e, caso confirmado, efetuar a devolução do valor.",
		"responseTime": "0001-01-01T00:00:00",
		"analysisResult": "DISAGREED",
		"contactCreator": {
			"contactEmail": "[email protected]",
			"contactPhone": "+5511999935786"
		},
		"endToEndId": "E1057352120260416191181XDS9fTfUf",
		"reportedBy": "DEBITED_PARTICIPANT",
		"infractionData": {
			"infractingAccountData": {
				"branch": 0
			},
			"debitedParticipant": "10573521",
			"reportedBy": "DEBITED_PARTICIPANT",
			"transactionDate": "0001-01-01T00:00:00",
			"creditedParticipant": "22181404"
		},
		"transactionId": "E1057352120260416191181XDS9fTfUf",
		"creditedParticipant": "22181404",
		"situationType": "ACCOUNT_TAKEOVER",
		"id": "96f2a8e0-8ee4-40f1-806d-49a7d818afb1",
		"debitedParticipant": "10573521",
		"lastModified": "2026-04-17T12:04:46.684+00:00",
		"status": "CLOSED"
	},
	"entity": "pix-infraction",
	"transactionId": 202604160000741630,
	"createTimestamp": "0001-01-01T00:00:00",
	"status": "CLOSED"
}

Evento: pix-infraction - CLOSED / analysisResult: "AGREED" (Aceita)

{
	"lastUpdateTimestamp": "0001-01-01T00:00:00",
	"webhookId": "infraction-CLOSED-96f2a8e0-8ee4-40f1-806d-49a7d818afb1",
	"body": {
		"analysisDetails": "Em contato com o cliente, não foi identificado fraude.",
		"infractionType": "REFUND_REQUEST",
		"creationTime": "2026-04-17T00:31:25.908+00:00",
		"reportDetails": "Usuário pagador contestou a transação via fluxo formal previsto pelo MED. Favor avaliar se há indícios de fraude e, caso confirmado, efetuar a devolução do valor.",
		"responseTime": "0001-01-01T00:00:00",
		"analysisResult": "AGREED",
		"contactCreator": {
			"contactEmail": "[email protected]",
			"contactPhone": "+5511999935786"
		},
		"endToEndId": "E1057352120260416191181XDS9fTfUf",
		"reportedBy": "DEBITED_PARTICIPANT",
		"infractionData": {
			"infractingAccountData": {
				"branch": 0
			},
			"debitedParticipant": "10573521",
			"reportedBy": "DEBITED_PARTICIPANT",
			"transactionDate": "0001-01-01T00:00:00",
			"creditedParticipant": "22181404"
		},
		"transactionId": "E1057352120260416191181XDS9fTfUf",
		"creditedParticipant": "22181404",
		"situationType": "ACCOUNT_TAKEOVER",
		"id": "96f2a8e0-8ee4-40f1-806d-49a7d818afb1",
		"debitedParticipant": "10573521",
		"lastModified": "2026-04-17T12:04:46.684+00:00",
		"status": "CLOSED"
	},
	"entity": "pix-infraction",
	"transactionId": 202604160000741630,
	"createTimestamp": "0001-01-01T00:00:00",
	"status": "CLOSED"
}

Evento: pix-infraction - CANCELLED

{
	"lastUpdateTimestamp": "2026-04-16T16:44:24.867",
	"pactualId": "01000000-534d-774a-0353-08de9bf08f1e",
	"clientRequestId": "",
	"body": {
		"infractionType": "REFUND_REQUEST",
		"creationTime": "2026-04-16T17:16:20.637",
		"reportDetails": "fizeram um pix sem meu conhecimento preciso do estorno do valor",
		"responseTime": "2026-04-16T16:44:24.867",
		"endToEndId": "E20855875202604161943PGGLW8G9TKD",
		"reportedBy": "DEBITED_PARTICIPANT",
		"infractionData": {
			"taxIdNumber": "93763425187",
			"infractingAccountData": {
				"accountNumber": "481163665",
				"branch": 1
			},
			"debitedParticipant": "20855875",
			"reportedBy": "DEBITED_PARTICIPANT",
			"transactionDate": "2026-04-16T16:44:24.867",
			"creditedParticipant": "13935893",
			"key": "06c224da-23a0-40ea-91dc-78d45c3c824a"
		},
		"transactionId": "E20855875202604161943PGGLW8G9TKD",
		"creditedParticipant": "13935893",
		"transactionType": "TRANSFER",
		"id": "7df553a4-47ef-46f5-88d4-f70a29373ef7",
		"debitedParticipant": "20855875",
		"lastModified": "2026-04-17T08:16:55.41",
		"status": "CANCELLED"
	},
	"entity": "pix-infraction ",
	"transactionId": 202604160000781380,
	"createTimestamp": "2026-04-16T16:44:24.867",
	"status": "CANCELLED"
}

Notificações para acompanhar o fechamento da devolução em recuperação de valores

Eventos	Status	Descrição
pix-med-refund	OPEN	Indica que a solicitação está aberto e é possível realizar a devolução dos valores.
pix-med-refund	CLOSED	Indica que a solicitação de devolução foi encerrada Ela retornar como: valor total recuperado (TOTALLY_ACCEPTED), valor parcial recuperado (PARTIALLY_ACCEPTED) ou nenhum valor recuperado (REJECTED)
pix-med-refund	CANCELLED	Indica que a solicitação de devolução foi cancelada

Exemplos de webhook

Evento: pix-med-refund - OPEN

{
	"lastUpdateTimestamp": "2026-04-16T22:16:23.49",
	"clientRequestId": "616",
	"clientCode": "",
	"body": {
		"creationTime": "04/16/2026 22:16:23",
		"refundReason": "FRAUD",
		"responseTime": "04/16/2026 22:16:23",
		"refundDetails": "requisitante não forneceu detalhes",
		"transactionId": "E270980602026032213302udnP7vnwJT",
		"requestingParticipant": "27098060",
		"monitorAccount": true,
		"contestedParticipant": "13935893",
		"infractionReportId": "d8a2dab0-56e1-4aa0-98c2-16f2feac6817",
		"fundsRecoveryId": "81a15e14-ff7a-4f34-9e01-57172bde7f4a",
		"id": "64e1badf-beef-430b-ab90-803e6294a937",
		"lastModified": "04/16/2026 22:16:23",
		"originalEndToEndId": "E270980602026032213302udnP7vnwJT",
		"refundAmount": "200.00",
		"status": "OPEN"
	},
	"entity": "pix-med-refund",
	"transactionId": 202603220000253200,
	"createTimestamp": "2026-04-16T22:16:23.49",
	"status": "OPEN"
}

Evento: pix-med-refund - CLOSED

{
	"lastUpdateTimestamp": "2026-04-16T23:50:16.953",
	"clientRequestId": "244",
	"clientCode": "",
	"body": {
		"creationTime": "04/11/2026 11:03:13",
		"refundReason": "FRAUD",
		"responseTime": "04/16/2026 23:50:16",
		"refundTransactionId": "D00360305202604111107216a58fdd5f",
		"refundDetails": "aceita",
		"analysisResult": "PARTIALLY_ACCEPTED",
		"transactionId": "E13935893202603200316XlXWHOVwubV",
		"requestingParticipant": "13935893",
		"monitorAccount": false,
		"contestedParticipant": "00360305",
		"infractionReportId": "519f4f85-f403-4b5c-aa7a-a9c8557e2c7f",
		"returnIdentification": "D00360305202604111107216a58fdd5f",
		"id": "ce49c333-1438-4610-bb4a-d33aa9530a69",
		"lastModified": "04/16/2026 23:50:16",
		"originalEndToEndId": "E13935893202603200316XlXWHOVwubV",
		"refundAmount": "14994.5000",
		"status": "CLOSED"
	},
	"entity": "pix-med-refund",
	"transactionId": 202603200000011360,
	"createTimestamp": "2026-04-11T11:03:13.58",
	"status": "CLOSED"
}

Evento: pix-med-refund - CANCELLED

{
	"lastUpdateTimestamp": "2026-04-16T22:16:23.49",
	"clientRequestId": "616",
	"clientCode": "",
	"body": {
		"creationTime": "04/16/2026 22:16:23",
		"refundReason": "FRAUD",
		"responseTime": "04/16/2026 22:16:23",
		"refundDetails": "requisitante não forneceu detalhes",
		"transactionId": "E270980602026032213302udnP7vnwJT",
		"requestingParticipant": "27098060",
		"monitorAccount": true,
		"contestedParticipant": "13935893",
		"infractionReportId": "d8a2dab0-56e1-4aa0-98c2-16f2feac6817",
		"fundsRecoveryId": "81a15e14-ff7a-4f34-9e01-57172bde7f4a",
		"id": "64e1badf-beef-430b-ab90-803e6294a937",
		"lastModified": "04/16/2026 22:16:23",
		"originalEndToEndId": "E270980602026032213302udnP7vnwJT",
		"refundAmount": "200.00",
		"status": "CANCELLED"
	},
	"entity": "pix-med-refund",
	"transactionId": 202603220000253200,
	"createTimestamp": "2026-04-16T22:16:23.49",
	"status": "CANCELLED"
}

Notificações para acompanhar bloqueio e desbloqueio de valores nas contas:

Eventos	Descrição
pix-med-balance-blocked	Bloqueio de saldo MED.
pix-med-balance-unblocked	Desbloqueio de saldo MED.

Exemplos de webhook

Evento: pix-med-balance-blocked - Bloqueio de saldo total.

{
    "webhookId": "InfractionBlock-dc9c7877-ea4f-4804-ad36-3a336ec59570",
    "body": {
        "blockId": "123456789",
        "fundsRecoveryId": "dc9c7877-ea4f-4804-ad36-3a336ec595",
        "blockMode": "TOTAL",
        "reason": "FRAUD_INVESTIGATION",
        "reasonDescription": "Transação suspeita de fraude e foi aberto uma recuperação de valores para ela",
        "infractionId": "dc9c7877-ea4f-4804-ad36-3a336ec59570",
        "amounts": {
            "requestedBlockAmount": 100,
            "blockedAmount": 100,
            "previusBlockedAmount": 0,
            "remainingToBlockAmount": 0,
            "totalBlockedAmount": 100
        },
        "account": {
            "bank": "12345678",
            "taxId": "00000000000",
            "name": "Fulano",
            "branch": "0001",
            "account": "438582942"
        },
        "transaction": {
            "debitParty": {
                "bank": "87456132",
                "taxId": "00000000000",
                "name": "Ciclano",
                "branch": "0001",
                "account": "00000000"
            },
            "endToEnd": "E08561701202601160011KVI1D1O641M",
            "creditParty": {
                "bank": "12345678",
                "taxId": "00000000000",
                "name": "Fulano",
                "branch": "0001",
                "account": "438582942"
            }
        },
        "status": "TOTALY_BLOCKED"
    },
    "entity": "pix-med-balance-blocked",
    "createTimestamp": "2026-02-13T19:40:25.7277196Z",
    "status": "TOTALY_BLOCKED"
}

Evento: pix-med-balance-blocked - Bloqueio de saldo parcial

{
    "webhookId": "InfractionBlock-dc9c7877-ea4f-4804-ad36-3a336ec59570",
    "body": {
        "blockId": "123456789",
        "fundsRecoveryId": "dc9c7877-ea4f-4804-ad36-3a336ec595",
        "blockMode": "TOTAL",
        "reason": "FRAUD_INVESTIGATION",
        "reasonDescription": "Transação suspeita de fraude e foi aberto uma recuperação de valores para ela",
        "infractionId": "dc9c7877-ea4f-4804-ad36-3a336ec59570",
        "amounts": {
            "requestedBlockAmount": 100,
            "blockedAmount": 20,
            "previusBlockedAmount": 0,
            "remainingToBlockAmount": 80,
            "totalBlockedAmount": 20
        },
        "account": {
            "bank": "12345678",
            "taxId": "00000000000",
            "name": "Fulano",
            "branch": "0001",
            "account": "438582942"
        },
        "transaction": {
            "debitParty": {
                "bank": "87456132",
                "taxId": "00000000000",
                "name": "Ciclano",
                "branch": "0001",
                "account": "00000000"
            },
            "endToEnd": "E08561701202601160011KVI1D1O641M",
            "creditParty": {
                "bank": "12345678",
                "taxId": "00000000000",
                "name": "Fulano",
                "branch": "0001",
                "account": "438582942"
            }
        },
        "status": "PARTIAL_BLOCKED"
    },
    "entity": "pix-med-balance-blocked",
    "createTimestamp": "2026-02-13T19:40:25.7277196Z",
    "status": "PARTIAL_BLOCKED"
}

Evento: pix-med-balance-unblocked - Desbloqueio de saldo total

{
    "webhookId": "InfractionUnblock-134a2fa5-2a04-4d17-871e-8202d37955a1",
    "body": {
        "blockId": "123456789",
        "fundsRecoveryId": "134a2fa5-2a04-4d17-871e-8202d37955a1",
        "unblockReasonDescription": "Descrição do motivo de desbloqueio",
        "infractionId": "134a2fa5-2a04-4d17-871e-8202d37955a1",
        "amounts": {
            "unblockedAmount": 1.33,
            "totalBlockedAmount": 1.33
        },
        "unblockReason": "DISAGREED",
        "account": {
            "bank": "12345678",
            "taxId": "12345678911",
            "name": "Fulano",
            "branch": "0001",
            "account": "466428646"
        },
        "transaction": {
            "debitParty": {
                "bank": "87654321",
                "taxId": "12345678911",
                "name": "Ciclano",
                "branch": "0001",
                "account": "0000000"
            },
            "endToEnd": "E44471172202602131011U00c73d07",
            "creditParty": {
                "bank": "12345678",
                "taxId": "13245678911",
                "name": "Fulano",
                "branch": "0001",
                "account": "000000000"
            }
        },
        "status": "UNBLOCKED"
    },
    "entity": "pix-med-balance-unblocked",
    "createTimestamp": "2026-02-13T19:28:24.354789Z",
    "status": "UNBLOCKED"
}

Evento: pix-med-balance-unblocked - Desbloqueio de saldo parcial

{
    "webhookId": "InfractionUnblock-134a2fa5-2a04-4d17-871e-8202d37955a1",
    "body": {
        "blockId": "123456789",
        "fundsRecoveryId": "134a2fa5-2a04-4d17-871e-8202d37955a1",
        "unblockReasonDescription": "Descrição do motivo de desbloqueio",
        "infractionId": "134a2fa5-2a04-4d17-871e-8202d37955a1",
        "amounts": {
            "unblockedAmount": 100.33,
            "totalBlockedAmount": 200.33
        },
        "unblockReason": "DISAGREED",
        "account": {
            "bank": "12345678",
            "taxId": "12345678911",
            "name": "Fulano",
            "branch": "0001",
            "account": "466428646"
        },
        "transaction": {
            "debitParty": {
                "bank": "87654321",
                "taxId": "12345678911",
                "name": "Ciclano",
                "branch": "0001",
                "account": "0000000"
            },
            "endToEnd": "E44471172202602131011U00c73d07",
            "creditParty": {
                "bank": "12345678",
                "taxId": "13245678911",
                "name": "Fulano",
                "branch": "0001",
                "account": "000000000"
            }
        },
        "status": "UNBLOCKED"
    },
    "entity": "pix-med-balance-unblocked",
    "createTimestamp": "2026-02-13T19:28:24.354789Z",
    "status": "UNBLOCKED"
}

Updated about 2 hours ago