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

POST

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

Este é o evento que você espera para liberar o produto/serviço para o cliente.

Disparado quando o pagador efetiva o PIX. Inclui:

status: "PAID"

paidAt (ISO8601 do pagamento)

payer com nome e CPF/CNPJ mascarados do pagador real

netAmount (valor líquido após splits, em centavos) — só presente se a cobrança teve splits

splits[] (status final de cada split) — só presente se houver

Idempotência: se você responder 200 mas o webhook chegar duplicado, trate como o mesmo pagamento. Use data.id (ou o externalId que você passou no correlationID) como chave de deduplicação.

Requisição

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' \
--header 'X-Webhook-Signature: t=1714000300000,v1=<hex_de_HMAC_SHA256(secret, timestamp + '\''.'\'' + body)>' \
--header 'X-Webhook-Event: EVENT:CHARGE_PAID' \
--header 'X-Webhook-ID: clev02j3l4m5n6p7q8r9s0t1u2' \
--header 'X-Webhook-Timestamp: 2026-05-07T14:35:12.000Z' \
--header 'Content-Type: application/json' \
--data-raw '{
  "event": "EVENT:CHARGE_PAID",
  "timestamp": "2026-05-07T14:35:12.000Z",
  "data": {
    "id": "clxxx0001",
    "externalId": null,
    "brCode": "00020126360014BR.GOV.BCB.PIX0114+5511999998888...",
    "qrCodeUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
    "paymentLink": "https://app.dotfy.com.br/checkout/dotfy-1714000000000-abc12345",
    "amount": 2990,
    "expiresAt": "2026-05-07T15:30:00.000Z",
    "createdAt": "2026-05-07T14:30:00.000Z",
    "status": "PAID",
    "paidAt": "2026-05-07T14:35:12.000Z",
    "customer": {
      "id": "12345678901",
      "name": "Maria Silva",
      "document": "123.456.789-01",
      "email": "maria@exemplo.com",
      "phone": "(11) 99999-8888"
    },
    "payer": {
      "name": "Maria Silva",
      "taxId": "***456***"
    },
    "netAmount": 2691,
    "splits": [
      {
        "email": "parceiro@exemplo.com",
        "type": "PERCENT",
        "value": 10,
        "amount": 299,
        "status": "COMPLETED"
      }
    ]
  }
}'

Response Example

{}

Modificado em 2026-05-07 16:12:35

Página anterior

EVENT:CHARGE_CREATED — cobrança criada

Próxima página

EVENT:CHARGE_EXPIRED — cobrança expirada