Webhooks de Bloqueio Judicial

Neste artigo explicamos como funcionam os Webhooks relacionados ao bloqueio judicial.

---

O bloqueio judicial ocorre sempre que uma ordem judicial é expedida ao Stark Bank em relação a uma conta de cliente.

Para identificar esse bloqueio via API, você pode ativar a subscription credit-block.

o retorno do webhook ocorrerá da seguinte forma:

Bloqueio

* O type será retornado como "created":

{
  "event": {
    "created": "2025-09-29T20:40:01.573927+00:00",
    "id": "5789476116758528",
    "log": {
      "block": {
        "amount": 130000,
        "created": "2025-09-29T20:26:45.534041+00:00",
        "id": "",
        "senderId": "organization-asset-block/billing/6235148253134848/2025-04-30",
        "source": "organization-asset-block/billing/6235148253134848/2025-04-30",
        "status": "active",
        "tags": [],
        "transactionId": null,
        "type": "contractual",
        "workspaceId": "organization-asset-block/billing/6235148253134848/2025-04-30"
      },
      "created": "2025-09-29T20:26:45.566164+00:00",
      "errors": [],
      "id": "5114942998970368",
      "type": "created"
    },
    "subscription": "credit-block",
    "workspaceId": "6235148253134848"
  }
}

Desbloqueio

* O type será retornado como "canceled":

{
  "event": {
    "created": "2025-09-29T20:42:07.147453+00:00",
    "id": "5647453963419648",
    "log": {
      "block": {
        "amount": 130000,
        "created": "2025-09-29T20:26:45.534041+00:00",
        "id": "",
        "senderId": "organization-asset-block/billing/6235148253134848/2025-04-30",
        "source": "organization-asset-block/billing/6235148253134848/2025-04-30",
        "status": "canceled",
        "tags": [],
        "transactionId": null,
        "type": "contractual",
        "workspaceId": "organization-asset-block/billing/6235148253134848/2025-04-30"
      },
      "created": "2025-09-29T20:42:06.244622+00:00",
      "errors": [],
      "id": "5768407551049728",
      "type": "canceled"
    },
    "subscription": "credit-block",
    "workspaceId": "6235148253134848"
  }
}

⚠️ Sem a criação de uma subscription via API, não é possível receber esses eventos.
Saiba como criar uma subscription: https://starkbank.com/docs/api#webhook

Caso tenha qualquer dúvida durante o processo, você pode entrar em contato com o nosso time pelo e-mail [e-mail], teremos prazer em ajudar!