Devolução de valores

Quando é aceito uma recuperação de valores (AGREED), será aberto pela IF da vítima de fraude uma solicitação de devolução em recuperação de valores em até 6 horas. Você, cliente Celcoin, receberá essa notificação de devolução via webhook de pix-med-refund.

O objeto de refundaccount trará os dados para devolução, o campo monitorAccount indica os casos onde o Bacen/DICT estabelece que independente de ter saldo ou não, a instituição recebedora deverá continuar monitorando esta conta para possíveis cash in. O campo fundsrecoveryid, que é o identificador da recuperação de valores, além de outros campos como o refundamount com o valor indicado para devolução.

Primeiramente, será recebido o webhook com o status "Open", que indica que a solicitação está aberto e é possível realizar a devolução dos valores.

Exemplo de recebimento de solicitação de devolução status OPEN webhook pix-med-refund:

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

❗️

Se no webhook o campo refundaccount vier preenchido com dados da conta, indica que seu usuário é de contas subsequentes da fraude e deverá ser feito uma transação para os dados da conta contido no campo refundaccount, onde o titular da conta que fará a devolução deverá ser o participante indireto e não o titular da conta do usuário. Essa regra é estipulada pelo Banco Central.

Caso o campo "refundaccount" não venha preenchido, basta fazer a devolução da transação recebida.

Fechamento uma solicitação de devolução quando seu usuário é a transação raiz (campo "refundaccount" não preenchido)

A devolução de valores via devolução Pix, ocorre quando a Celcoin é identificada como participante da transação raiz objeto da fraude no fluxo do MED 2.0.

Neste cenário, o valor recuperado e previamente bloqueado, será devolvido diretamente à instituição de origem da transação contestada, seguindo o fluxo regulatório de devolução.

Forma de Processamento:

• A operação é realizada por meio de mensagem de devolução Pix (pacs.004);
• A devolução ocorre diretamente dentro do arranjo Pix;
• O débito não impacta valores que não estejam previamente bloqueados;
• O valor devolvido corresponde ao montante efetivamente bloqueado e recuperado;
• O cliente final visualizará no extrato um lançamento caracterizado como devolução de Pix, sendo o tipo da transação "PIXREVERSALOUT"
• Um Webhook será enviado ao cliente conforme abaixo:

Exemplo de webhook

{
  "webhookId": "c18c4967-2071-405d-9e88-c2f13994fc88",
  "body": {
    "reason": "FRAUD_INVESTIGATION",
    "amount": 0.01,
    "correlationBlockedId": "3e8b3dbf-8da8-4acd-b3e7-bb11055a3320",
    "taxId": "66877376781",
    "clientCode": "a4bbc5b0-dd62-4d87-ab29-19564b8e7955",
    "name": "Frank Mante",
    "description": "Saldo bloqueado Med",
    "id": "c18c4967-2071-405d-9e88-c2f13994fc88",
    "type": "blocked-amount",
    "branch": "0001",
    "account": "30023646094074"
  },
  "entity": "balance-amount-event",
  "createTimestamp": "2026-02-20T12:22:15.0803751",
  "status": "CONFIRMED"
}

Fechando uma solicitação de devolução quando seu usuário é de contas/camadas subsequentes

Se caso a o webhook pix-med-refund de status OPEN vier com o campo "refundaccount" preenchido com dados da conta, indicará que seu usuário é de conta subsequente da conta recebedor da transação raiz de fraude. Nesse caso, caso a devolução ocorrerá de uma outra forma, conforme estipula o Banco Central.

Nesses casos, a análise do grafo transacional indica que os valores fraudulentos foram distribuídos entre múltiplas instituições financeiras, sendo necessário realizar a centralização do valor recuperado antes da devolução à instituição indicada no processo regulatório.

Sendo assim, o saldo saldo bloqueado será retirado da conta do usuário fraudador e será transferido via TEF (Transferência interna) para uma conta de titularidade da Celcoin, com o saldo já na conta , será feito uma nova transação de pix cash out com destino para os dados da conta que vieram no campo "refundaccount" via webhook,

Forma de Processamento:

• Ocorrerá uma transferência interna (TEF) do valor bloqueado da conta do cliente;
• Crédito será realizado em uma conta interna de titularidade da Celcoin;
• Para posterior envio do valor via Pix para a instituição indicada no fluxo do MED 2.0;
• Esse procedimento garante conformidade operacional e rastreabilidade da devolução regulatória.
• O cliente final visualizará no extrato um lançamento de débito identificado como Transferência Interna (TEF), sendo o tipo da transação "TEFTRANSFEROUT"
• Um Webhook será enviado ao cliente conforme abaixo:

Exemplo de webhook

{
  "entity": "internal-transfer-out",
  "createTimestamp": "2023-07-20T09:43:53.2077798",
  "status": "CONFIRMED",
  "body": {
    "id": "c4ab9f3d-2b25-4b8a-a6b2-7f277742db05",
    "amount": 0.01,
    "clientRequestId": "124eb1e5-62b9-492b-9d13-dc8a58786305",
    "creditParty": {
      "account": "123456",
      "taxId": "123456",
      "name": "nome credito",
      "branch": "0001",
      "bank": "13935893"
    },
    "debitParty": {
      "account": "123456",
      "taxId": "123456",
      "name": "nome debito",
      "branch": "0001",
      "bank": "13935893"
    },
    "endToEndId": "e25598a9-5278-4219-a278-ae5e3602dcae",
    "description": "transferencia med"
  }
}

Após a finalização deste processo, será enviado um webhook indicando que a solicitação de devolução foi encerrada.

Exemplo de webhook status CLOSED
entidade: pix-med-refund

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