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
      • Cartão (Checkout Transparente)
        • Criar pagamento com cartão (PAN via API)
      • 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
        • Links de compra por comprador (Purchase Links)
          • Criar link de compra (por comprador)
          • Listar links de compra do produto
          • Detalhe/status do link de compra
          • Revogar link de compra
        • 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
      • Subcontas White-Label (BaaS)
        • Criar subconta
        • Listar subcontas
        • Detalhe da subconta
        • Atualizar subconta
        • Excluir subconta (soft delete)
        • Enviar KYC da subconta (multipart)
        • Consultar status do KYC da subconta
        • Cadastrar chave PIX da subconta
        • Listar chaves PIX da subconta
        • Remover chave PIX da subconta
        • Criar cobrança da subconta
        • Listar cobranças da subconta
        • Detalhe de cobrança da subconta
        • Saldo da subconta
        • Extrato (transações) da subconta
        • Solicitar saque da subconta
        • Listar saques da subconta
        • Atualizar taxas da subconta
      • 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
        • EVENT:SUBACCOUNT_KYC_APPROVED — KYC da subconta aprovado
          POST
        • EVENT:SUBACCOUNT_KYC_REJECTED — KYC da subconta recusado
          POST
        • EVENT:SUBACCOUNT_PIX_KEY_APPROVED — chave PIX da subconta aprovada
          POST
        • EVENT:SUBACCOUNT_PIX_KEY_REJECTED — chave PIX da subconta recusada
          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_EXPIRED — cobrança expirada

POST
https://seu-dominio.com/webhooks/dotfy
Disparado quando o expiresAt passa sem pagamento, OU quando ocorre um estorno total (alguns adquirentes). Use para cancelar pedidos pendentes no seu sistema.

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 Request Example
Shell
JavaScript
Java
Swift
curl --location 'https://seu-dominio.com/webhooks/dotfy?event=charge-expired' \
--header 'X-Webhook-Signature: t=1714003800000,v1=<hex_de_HMAC_SHA256(secret, timestamp + '\''.'\'' + body)>' \
--header 'X-Webhook-Event: EVENT:CHARGE_EXPIRED' \
--header 'X-Webhook-ID: clev03k4m5n6p7q8r9s0t1u2v3' \
--header 'X-Webhook-Timestamp: 2026-05-07T15:30:00.000Z' \
--header 'Authorization: Bearer <token>' \
--header 'Content-Type: application/json' \
--data '{
  "event": "EVENT:CHARGE_EXPIRED",
  "timestamp": "2026-05-07T15:30:00.000Z",
  "data": {
    "id": "clxxx0001",
    "externalId": null,
    "correlationId": null,
    "brCode": "00020126...",
    "qrCode": "00020126...",
    "qrCodeUrl": "data:image/png;base64,iVBORw0KGgoAAAANSUhEUg...",
    "paymentLink": "https://app.dotfy.com.br/checkout/...",
    "amount": 2990,
    "expiresAt": "2026-05-07T15:30:00.000Z",
    "createdAt": "2026-05-07T14:30:00.000Z",
    "status": "EXPIRED",
    "paidAt": null,
    "customer": null
  }
}'
Response Response Example
{}
Modificado em 2026-07-02 06:57:27
Página anterior
EVENT:CHARGE_PAID — cobrança paga (atualização principal)
Próxima página
EVENT:SPLIT_RECEIVED — você recebeu um split
Built with