Comunicar uma fraude e recuperar fundos

Comunique um Pix que seu cliente pagou em uma fraude e peça ao DICT que recupere os fundos.

Este fluxo é uma leitura sugerida dos manuais do BACEN para o Pix. Os manuais prevalecem sobre esta página. Sua instituição, como participante, valida o fluxo e o implementa sobre as APIs da Lerian. Veja como ler os diagramas.

Participantes

Sua instituição. O participante do Pix do cliente pagador. Abre a recuperação e a acompanha.
Pix Lerian. Guarda a recuperação e publica cada mudança.
Lerian SPI. Troca a recuperação com o DICT e lê as mudanças dela no DICT.
DICT. O diretório do BACEN. Rastreia os fundos e conduz a recuperação com os participantes recebedores.

Antes de começar

O Pix saiu de uma conta da sua instituição nos últimos 80 dias. Guarde o ID end-to-end dele.
Seus sistemas recebem os eventos do Pix Lerian. Veja Eventos do Pix Lerian.

Diagrama

Abrir a recuperação

#	Origem	Destino	Mensagem	API da Lerian	O que acontece
1	Sua instituição	Pix Lerian	API da Lerian	`POST /dict/funds-recoveries`	Abra a recuperação com a conta, o ID end-to-end do Pix em `rootTransactionId`, o `situationType` e o contato do seu cliente. Envie o cabeçalho `X-Idempotency`.
2	Pix Lerian	Lerian SPI	Chamada interna		O Pix Lerian envia a recuperação ao Lerian SPI.
3	Lerian SPI	DICT	API do DICT		O Lerian SPI abre a recuperação no DICT.
4	Pix Lerian	Sua instituição	API da Lerian	Resposta ao passo 1	O Pix Lerian responde `201` com a recuperação em `CREATED`. Um `202` significa que o DICT ainda não a confirmou: a recuperação fica `PENDING`.
5	DICT	DICT	Passo interno		O DICT rastreia para onde os fundos foram e abre os relatórios de infração da recuperação.
6	Lerian SPI	DICT	API do DICT		O Lerian SPI lê as mudanças da recuperação.
7	Lerian SPI	Pix Lerian	Chamada interna		O Lerian SPI repassa cada mudança ao Pix Lerian.
8	Pix Lerian	Sua instituição	API da Lerian	Evento `funds_recovery.updated`	A recuperação mudou de status, por exemplo para `TRACKED` ou `ANALYSED`.
9	Sua instituição	Pix Lerian	API da Lerian	`GET /dict/funds-recoveries/{id}/tracking-graph`	Leia para onde os fundos foram.
10	Sua instituição	Pix Lerian	API da Lerian	`GET /dict/funds-recoveries/{id}/infraction-reports`	Leia os relatórios de infração da recuperação.

Pedir a devolução

#	Origem	Destino	Mensagem	API da Lerian	O que acontece
1	Sua instituição	Pix Lerian	API da Lerian	`POST /dict/funds-recoveries/{id}/refund`	Peça a devolução de uma recuperação em `ANALYSED`. Envie o cabeçalho `X-Idempotency`.
2	Pix Lerian	Lerian SPI	Chamada interna		O Pix Lerian envia o pedido de devolução ao Lerian SPI.
3	Lerian SPI	DICT	API do DICT		O Lerian SPI envia o pedido de devolução ao DICT.
4	Pix Lerian	Sua instituição	API da Lerian	Resposta ao passo 1	O Pix Lerian responde `200` com a recuperação em `REFUNDING`.
5	Lerian SPI	DICT	API do DICT		O Lerian SPI lê as mudanças da recuperação.
6	Lerian SPI	Pix Lerian	Chamada interna		O Lerian SPI repassa cada mudança ao Pix Lerian.
7	Pix Lerian	Sua instituição	API da Lerian	Evento `funds_recovery.updated`	A recuperação fica `COMPLETED`.

Regras

situationType é um de SCAM, ACCOUNT_TAKEOVER, COERCION, FRAUDULENT_ACCESS, OTHER ou UNKNOWN. Com OTHER, descreva o caso em reportDetails.
Um Pix aceita uma recuperação. Uma recuperação cancelada também conta.
Uma recuperação é um caso no DICT. O status dela, sozinho, não mostra que os fundos voltaram.
Para encerrar uma recuperação, cancele-a com POST /dict/funds-recoveries/{id}/cancel.

Como saber que terminou

O Pix Lerian publica funds_recovery.updated, e GET /dict/funds-recoveries/{id} mostra a recuperação em COMPLETED.

O que pode dar errado

Situação	O que você vê	O que fazer
O Pix já tem uma recuperação.	`409`, código `PIX-0113`.	Acompanhe a recuperação que já existe.
O Pix é mais antigo que o prazo do DICT.	`422`, código `PIX-0117`.	O DICT não aceita a recuperação.
O DICT ainda não resolveu a operação.	`409`, código `PIX-0118`.	Guarde o `operationId`. Leia a recuperação mais tarde. Não envie um novo pedido.
A recuperação não está em `ANALYSED`.	`409`, código `PIX-0114`.	Aguarde `funds_recovery.updated` com `ANALYSED`.
A resposta a um pedido não chega.	Nenhuma resposta, ou um timeout.	Envie o mesmo pedido de novo com a mesma chave `X-Idempotency`.

A lista de erros do Pix Lerian descreve cada código.

Visão geral

Crédito com garantia

Pagamentos

Liquidação e operação diária

Consignado CLT (Dataprev)

Comunicar uma fraude e recuperar fundos

Participantes

Antes de começar

Diagrama

Abrir a recuperação

Pedir a devolução

Regras

Como saber que terminou

O que pode dar errado

Relacionados

​Participantes

​Antes de começar

​Diagrama

​Abrir a recuperação

​Pedir a devolução

​Regras

​Como saber que terminou

​O que pode dar errado

​Relacionados

Participantes

Antes de começar

Diagrama

Abrir a recuperação

Pedir a devolução

Regras

Como saber que terminou

O que pode dar errado

Relacionados