EVENT:SUBACCOUNT_KYC_REJECTED — KYC da subconta recusado - Dotfy

Evento entregue nos endpoints do MASTER (a subconta é headless). Para recebê-lo, o endpoint do master precisa estar inscrito em EVENT:SUBACCOUNT_KYC_REJECTED.

Disparado quando o time da Dotfy recusa o KYC da subconta. A subconta permanece bloqueada para operar; reenvie a documentação corrigida via POST {{base_url}}/api/subaccounts/{{subaccount_id}}/kyc.

Payload (data):

subaccount.id / subaccount.correlationId / subaccount.name — identificação da subconta.

rejectionReason (string) — presente apenas em eventos de recusa; texto legível explicando o motivo (ex.: documento ilegível, dados divergentes do CNPJ, selfie não confere).

processedAt (string ISO 8601) — quando a decisão foi processada.

Neste evento o campo pixKey não aparece.

Sigilo: nenhuma informação de comissão/taxa do master aparece no payload.

Idempotência: use X-Webhook-ID como chave de deduplicação (até 5 tentativas com backoff exponencial em caso de falha de entrega).

Forneça seu token bearer no cabeçalho

Authorization

ao fazer requisições para recursos protegidos.

Exemplo:

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

curl --location 'https://seu-dominio.com/webhooks/dotfy?event=subaccount-kyc-rejected' \ --header 'X-Webhook-Signature: t=1714000401000,v1=<hex_de_HMAC_SHA256(secret, timestamp + '\''.'\'' + body)>' \ --header 'X-Webhook-Event: EVENT:SUBACCOUNT_KYC_REJECTED' \ --header 'X-Webhook-ID: EVENT:SUBACCOUNT_KYC_REJECTED:sub_clev0a1b2c3d4e5f6g7h8i9j0:1' \ --header 'X-Webhook-Timestamp: 2026-05-07T14:41:00.000Z' \ --header 'Authorization: Bearer <token>' \ --header 'Content-Type: application/json' \ --data '{ "event": "EVENT:SUBACCOUNT_KYC_REJECTED", "timestamp": "2026-05-07T14:41:00.000Z", "data": { "subaccount": { "id": "sub_clev0a1b2c3d4e5f6g7h8i9j0", "correlationId": "loja-parceira-001", "name": "Loja Parceira LTDA" }, "rejectionReason": "Documento ilegível: reenvie a foto da frente do documento com boa iluminação.", "processedAt": "2026-05-07T14:41:00.000Z" } }'

EVENT:SUBACCOUNT_KYC_REJECTED — KYC da subconta recusado

Requisição

Respostas