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.


Entidade de bloqueio: pix-med-balance-blocked


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


{
    "webhookId": "InfractionBlock-dc9c7877-ea4f-4804-ad36-3a336ec59570",
    "body": {
        "blockId": "1234",
        "reason": "FRAUD_INVESTIGATION",
        "reasonDescription": "pix fraudulento",
        "infractionId": "dc9c7877-ea4f-4804-ad36-3a336ec59570",
        "amounts": {
            "totalBlockedAmount": 0,
            "blockedAmount": 0
        },
        "account": {
            "bank": "13935893",
            "taxId": "12345678911",
            "name": "Fulano",
            "branch": "0001",
            "account": "87654321"
        },
        "transaction": {
            "debitParty": {
                "bank": "08561701",
                "taxId": "12345678999",
                "name": "Beltrano",
                "branch": "0001",
                "account": "12345678"
            },
            "endToEnd": "E08561701202601160011KVI1D1O641M",
            "creditParty": {
                "bank": "13935893",
                "taxId": "12345678000",
                "name": "Ciclano",
                "branch": "0001",
                "account": "438582942"
            }
        },
        "status": "BLOCKED"
    },
    "entity": "pix-med-balance-blocked",
    "createTimestamp": "2026-02-13T19:40:25.7277196Z",
    "status": "BLOCKED"
}


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


{
    "webhookId": "InfractionUnblock-134a2fa5-2a04-4d17-871e-8202d37955a1",
    "body": {
        "blockId": "99999",
        "unblockReasonDescription": "descrição",
        "infractionId": "134a2fa5-2a04-4d17-871e-8202d37955a1",
        "amounts": {
            "unblockedAmount": 1.33,
            "totalBlockedAmount": 1.33
        },
        "unblockReason": "DISAGREED",
        "account": {
            "bank": "13935893",
            "taxId": "1234568900",
            "name": "Fulano",
            "branch": "0001",
            "account": "466428646"
        },
        "transaction": {
            "debitParty": {
                "bank": "16501555",
                "taxId": "12345678999",
                "name": "Beltrano",
                "branch": "0001",
                "account": "123456"
            },
            "endToEnd": "E44471172202602131011U00c73d07da",
            "creditParty": {
                "bank": "13935893",
                "taxId": "12345678999",
                "name": "Ciclano",
                "branch": "0001",
                "account": "112233"
            }
        },
        "status": "UNBLOCKED"
    },
    "entity": "pix-med-balance-unblocked",
    "createTimestamp": "2026-02-13T19:28:24.354789Z",
    "status": "UNBLOCKED"
}

Tabela de apoio para Objeto "amounts"

CampoDetalhe
requestedBlockAmountValor solicitado pela infração para ser bloqueado
blockedAmountValor que foi bloqueado de fato
previusBlockedAmountValor bloqueado anteriormente
remainingToBlockAmountValor restante que falta ser bloqueado
totalBlockedAmountSoma dos valores bloqueados