1. Webhooks (Eventos Recebidos)
Dotfy - Documentação
  • Dotfy Module
    • Raiz
      • Conta (Dados do Seller)
        • Identificar a conta (dados do seller)
      • Cobranças PIX
        • Criar cobrança PIX
        • Listar cobranças
        • Consultar cobrança por correlationID
        • Histórico de webhooks de uma cobrança
      • Saldo
        • Consultar saldo
      • Saques e Chaves PIX
        • Listar chaves PIX cadastradas
        • Cadastrar chave PIX
        • Listar saques
        • Solicitar saque
        • Cancelar saque pendente
      • Clientes
        • Listar clientes
        • Detalhe de um cliente
      • Produtos e Links de Pagamento
        • Listar produtos
        • Criar produto
        • Detalhe do produto
        • Carrinhos abandonados do produto
      • Splits
        • Analytics de splits enviados
        • Splits recebidos
      • Disputas e MEDs
        • Listar disputas
        • Listar MEDs com estatísticas
        • Evidências de uma disputa
        • Histórico de uma disputa
      • Webhooks (Gerenciar Endpoints)
        • Listar endpoints
        • Criar endpoint
        • Atualizar endpoint
        • Remover endpoint
      • Webhooks (Eventos Recebidos)
        • EVENT:CHARGE_CREATED — cobrança criada
          POST
        • EVENT:CHARGE_PAID — cobrança paga (atualização principal)
          POST
        • EVENT:CHARGE_EXPIRED — cobrança expirada
          POST
        • EVENT:SPLIT_RECEIVED — você recebeu um split
          POST
        • EVENT:DISPUTE_OPENED — MED/disputa aberta
          POST
        • EVENT:DISPUTE_WON — disputa ganha
          POST
        • EVENT:DISPUTE_LOST — disputa perdida
          POST
        • EVENT:DISPUTE_CANCELED — disputa cancelada
          POST
        • EVENT:WITHDRAWAL_COMPLETED — saque concluído
          POST
        • EVENT:WITHDRAWAL_FAILED — saque falhou
          POST
      • Notificações
        • Listar notificações
      • Dashboard / Analytics
        • Stats gerais
        • Atividade recente
        • Atividade (timeline)
        • Receita por período
        • Volume por período
        • Taxa de conversão
        • Métodos de pagamento
        • Transações (gráfico)
        • Analytics avançado
  1. Webhooks (Eventos Recebidos)

EVENT:CHARGE_CREATED — cobrança criada

POST
https://seu-dominio.com/webhooks/dotfy
Disparado uma vez logo após a criação da cobrança via POST /api/charges. Útil para iniciar workflows internos antes do pagamento.

Requisição

Parâmetros de Consulta

Parâmetros Header

Parâmetros Bodyapplication/json

Examples

Respostas

🟢200
application/json
Bodyapplication/json

Request Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://seu-dominio.com/webhooks/dotfy?event=charge-created' \
--header 'X-Webhook-Signature: t=1714000000000,v1=<hex_de_HMAC_SHA256(secret, timestamp + '\''.'\'' + body)>' \
--header 'X-Webhook-Event: EVENT:CHARGE_CREATED' \
--header 'X-Webhook-ID: clev01h2k3m4n5p6q7r8s9t0u1' \
--header 'X-Webhook-Timestamp: 2026-05-07T14:30:00.000Z' \
--header 'Content-Type: application/json' \
--data-raw '{
  "event": "EVENT:CHARGE_CREATED",
  "timestamp": "2026-05-07T14:30:00.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": "ACTIVE",
    "customer": {
      "id": "12345678901",
      "name": "Maria Silva",
      "document": "123.456.789-01",
      "email": "maria@exemplo.com",
      "phone": "(11) 99999-8888"
    }
  }
}'
Response Response Example
{}
Modificado em 2026-05-07 16:12:35
Página anterior
Webhooks (Eventos Recebidos)
Próxima página
EVENT:CHARGE_PAID — cobrança paga (atualização principal)
Built with