Documentação
Status PageSuporte
  1. cel_banking - BaaS & Core
  2. MED 2.0
  3. Abertura de MED pelo cliente Celcoin

Recebimento de valores

Visão Geral

Quando é aceita uma recuperação de valores pela instituição recebedora dos recursos, e a fraude é formalmente reconhecida, inicia-se o processo de devolução dos valores recuperados no âmbito do MED 2.0.

Nesse momento, a instituição contraparte será responsável por executar a devolução dos valores recuperados à Celcoin, conforme os fluxos regulatórios do arranjo Pix.

Importante destacar que, o cliente BaaS não precisa realizar manualmente a solicitação, o crédito ou devolução dos recursos ao cliente final lesado. Todo o processamento de recebimento dos valores devolvidos e os respetivos repasses ao beneficiário final serão realizados diretamente pela Celcoin.

Dessa forma, o cliente BaaS atua apenas como consumidor das notificações e eventos do processo, não sendo responsável pela execução financeira da devolução ao usuário final.

Sendo assim, após a Celcoin realizar a solicitação de devolução, o cliente Celcoin receberá um Webhook (entidade: pix-med-refund) de fechamento da recuperação de valores (Status: CLOSED), contendo as informações da devolução processada.

Exemplos de webhook*

Entidade: pix-med-refund - Status: 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"
}

A partir desse evento, é importante compreender alguns pontos:

  1. A IF recebedora dos recursos poderá fechar a solicitação de devolução recebida, devolvendo o valor parcial, valor total ou respondendo que não há saldo. Sendo a identificação por meio do campo analysisResult, que poderá retornar como:
  • "TOTALLY_ACCEPTED" - Valor total recuperado
  • "PARTIALLY_ACCEPTED" - Valor parcial recuperado
  • "REJECTED" - Nenhum valor recuperado
  1. O tipo de devolução realizada, pode ocorrer em dois cenários distintos e essa diferenciação é identificada por meio do campo refundAccount no Webhook:
  • Quando o campo refundAccount não estiver preenchido
    • Indica que a devolução ocorre no contexto da transação primária (raiz), ou seja, quando os valores são devolvidos diretamente a partir da conta originalmente envolvida na fraude;
    • Neste cenário, o valor recuperado será visualizado no extrato do cliente como uma devolução de pix, sendo o tipo da transação "PIXREVERSALIN";
    • E o Webhook recebido será o pix-reversal-in.

Exemplo de webhook

Entidade: pix-reversal-in

{
  "body": {
    "reason": "FR01",
    "amount": 0.01,
    "debitParty": {
      "bank": "08561701",
      "taxId": "06237998128",
      "accountType": "CACC",
      "name": "Julio dos Santos",
      "branch": "1",
      "account": "305157919"
    },
    "originalClientCode": "14450e60-b740-4665-9108-bab848a66cfc",
    "oldBalance": 10901.28,
    "returnIdentification": "D08561701202602051455UWOFN2FB8OC",
    "id": "90a7429a-ef2e-4975-8750-eb1305f4ac0e",
    "originalId": "a76919e6-9c8e-465c-ac78-141727393757",
    "originalEntoEndId": "E13935893202602051451cIJnZoeWg5d",
    "creditParty": {
      "bank": "13935893",
      "taxId": "09362272148",
      "accountType": "TRAN",
      "name": "Roxanne Hodkiewicz",
      "branch": "0001",
      "account": "30023646056354"
    },
    "originalEndToEndId": "E13935893202602051451cIJnZoeWg5d"
  },
  "entity": "pix-reversal-in",
  "createTimestamp": "2026-02-05T11:55:16.9711438+00:00",
  "status": "CONFIRMED"
}

  • Quando o campo refundAccount estiver preenchido
    • Indica que a devolução está sendo realizada a partir de contas subsequentes no fluxo da fraude, isso significa que os valores foram recuperados a partir de contas que receberam transferências posteriores no fluxo transacional identificado pelo regulador.
    • Neste cenário, o valor recuperado será visualizado no extrato do cliente como uma entrada de pix, sendo o tipo da transação "PIXPAYMENTIN";
    • E o Webhook recebido será o pix-payment-in.

Exemplo de webhook

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

Updated about 2 hours ago