EVENT:CHARGE_PAID — boleto pago

POST

https://seu-dominio.com/webhooks/dotfy

EVENT:CHARGE_PAID — boleto pago

Mesmo envelope de qualquer cobrança paga, com data.paymentMethod: "BOLETO" e um objeto data.boleto (linha digitável + vencimento). É o payload que a Dotfy envia ao seu endpoint quando um boleto é compensado. Concilie por data.correlationId.

data.amount em centavos.

data.boleto.line = linha digitável; data.boleto.dueAt = vencimento. Não enviamos URLs externas do emissor.

Boleto não tem chargeback → o valor fica disponível para saque na hora.

Valide X-Webhook-Signature antes de confiar no payload (mesmo esquema HMAC dos demais eventos).

Requisição

Authorization

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

Authorization: Bearer ********************

Parâmetros de Consulta

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200

application/json

Bodyapplication/json

Request Example

Shell

JavaScript

Java

Swift

curl --location 'https://seu-dominio.com/webhooks/dotfy?event=charge-paid-boleto' \
--header 'X-Webhook-Signature: t=1721053800000,v1=<hex_de_HMAC_SHA256(secret, timestamp + '\''.'\'' + body)>' \
--header 'X-Webhook-Event: EVENT:CHARGE_PAID' \
--header 'X-Webhook-ID: clev_boleto_0001' \
--header 'X-Webhook-Timestamp: 2026-07-15T14:30:00.000Z' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data-raw '{
  "event": "EVENT:CHARGE_PAID",
  "timestamp": "2026-07-15T14:30:00.000Z",
  "data": {
    "id": "clch_boleto_0001",
    "externalId": "boleto_api_1714000000000_a1b2c3d4e5",
    "correlationId": "boleto_api_1714000000000_a1b2c3d4e5",
    "amount": 12990,
    "status": "PAID",
    "paymentMethod": "BOLETO",
    "boleto": {
      "line": "23793.38128 60007.827136 95000.063305 8 84410000012990",
      "dueAt": "2026-07-17T12:00:00.000Z"
    },
    "customer": {
      "name": "Maria Souza",
      "document": "390.***.**7-05",
      "email": "maria@exemplo.com",
      "phone": "+55 11 99999-8888"
    },
    "paidAt": "2026-07-15T14:30:00.000Z"
  }
}'

Response Example

{}

Modificado em 2026-07-14 04:02:21

Página anterior

EVENT:CHARGE_PAID — cobrança paga (atualização principal)

Próxima página

EVENT:CHARGE_EXPIRED — cobrança expirada

EVENT:CHARGE_PAID — boleto pago

EVENT:CHARGE_PAID — boleto pago#

Requisição

Respostas

EVENT:CHARGE_PAID — boleto pago