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