Bloqueio Cautelar - Recebimento Pix

O que é o Bloqueio Cautelar?

O bloqueio cautelar é um mecanismo exclusivo do PIX, criado para aumentar a segurança dos usuários.
Ele ocorre quando há suspeita de fraude. No momento do recebimento do PIX, os recursos são imediatamente bloqueados pela Celcoin, como instituição recebedora por até 72 horas, período no qual é realizada uma análise mais detalhada da transação.

Como o Bloqueio Cautelar funciona?

Ao receber uma transação de PIX Cash In que seja submetida ao bloqueio cautelar, você receberá um webhook informando que a transação está com status pendente (_Pending). Nosso time realizará a análise das informações da transação e determinará se o valor será liberado ou devolvido ao remetente. Essa análise pode durar até 72 horas (3 dias) corridos, contadas a partir do horário de envio do PIX. Durante esse período, o valor ficará na conta do cliente, porém bloqueado (_blockedAmount).

Quais as possibilidades depois da análise?

Se a análise for aprovada com sucesso: será enviado o webhook normal de cash in (pix-payment-in), com o status confirmed.

Se a análise for reprovada: também será envido o webhook com o status confirmed, porque o crédito na conta efetivamente aconteceu, mas logo na sequência será realizada a devolução compulsória do Pix pela Celcoin de forma automática deste saldo que estava previamente bloqueado.

📘

Mudança Crítica:
O campo Amount virá zerado (0.00) enquanto o valor não for liberado.
O valor real da transação estará no campo blockedAmount indicando que está em análise. Novos Campos: status: "PENDING" reason: Razão do bloqueio (ex: "BLOQUEIO CAUTELAR") expireDate: Data limite para análise.

Estes campos somente serão enviados para transações no status Pending.

Exemplo de webhook: transação em regra de bloqueio cautelar
Entity: pix-payment-in (Recebimento de Pix)

{
    "body": {
    "createTimeStamp": "2025-12-09T19:56:40.2992984",
    "body": {
      "initiationType": "DICT",
      "transactionType": "RECEIVEPIX",
      "amount": 0.0,
      "reason": "BLOQUEIO CAUTELAR",
      "blockedAmount": 10.0,
      "expireDate": "",
      "debitParty": {
        "bank": "13935893",
        "taxId": "47946051000174",
        "accountType": "SVGS",
        "name": "João da Silva",
        "branch": "0307",
        "account": "284372"
      },
      "urgency": "HIGH",
      "currentBalance": 13469.04,
      "oldBalance": 13469.04,
      "id": "3efcae4e-a788-4829-ab60-5b10981bb41d",
      "endToEndId": "E60701190202512092255DY5M1AFWOJH",
      "creditParty": {
        "bank": "13935893",
        "taxId": "47946051000174",
        "accountType": "TRAN",
        "name": "João da Silva",
        "branch": "0001",
        "key": "joã[email protected]",
        "account": "212151212"
      },
      "paymentType": "IMMEDIATE"
    },
    "entity": "pix-payment-in",
    "status": "PENDING"
  },
  "dataInicioTransacao": "2025-12-09T19:56:38",
  "entity": "pix-payment-in"
}

_