Bloqueio/desbloqueio de saldo por infração

Agora, ao receber uma notificação de infração, haverá um bloqueio automático do saldo na conta, no momento que a Celcoin receber a infração.

A transação será analisada em conjunto pelo parceiro da Celcoin e time de Fraudes da mesma forma que ocorre atualmente, com as respostas também pelo Painel do Cliente, conforme o fluxo atual.

O bloqueio poderá durar até os 7 dias de análise, conforme prazo do Banco Central e será liberado ou não, dependendo da resposta da análise.

👍
Este fluxo do bloqueio será automático e não será pedido consentimento para essa ação, conforme determinação do Banco Central.

O webhook de bloqueio, poderá vir com dois possíveis status, "status": "TOTALY_BLOCKED" ou "status": "PARTIAL_BLOCKED", eles indicam se o valor bloqueado foi total ou parcial referente ao valor da fraude.

Entidade de bloqueio: pix-med-balance-blocked

Exemplo de webhook de bloqueio de saldo por infração recebida: status": "TOTALY_BLOCKED

{
    "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": "TOTALY_BLOCKED"
    },
    "entity": "pix-med-balance-blocked",
    "createTimestamp": "2026-02-13T19:40:25.7277196Z",
    "status": "TOTALY_BLOCKED"
}

Exemplo de webhook de bloqueio de saldo por infração recebida: status": "PARTIAL_BLOCKED

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

Entidade de desbloqueio: pix-med-balance-unblocked
Exemplo de webhook de desbloqueio

{
    "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"
} (editado)

Tabela de apoio para Objeto "amounts"

Campo	Detalhe
requestedBlockAmount	Valor solicitado pela infração para ser bloqueado
blockedAmount	Valor que foi bloqueado de fato
previusBlockedAmount	Valor bloqueado anteriormente
remainingToBlockAmount	Valor restante que falta ser bloqueado
totalBlockedAmount	Soma dos valores bloqueados

Updated 11 days ago