---
title: "Documento de verificación rechazado"
method: POST
path: "verification-rejected-webhook"
---

# Documento de verificación rechazado

`POST verification-rejected-webhook` (webhook)

Se emite cuando el procesamiento en segundo plano descarta uno o más
documentos inválidos o ilegibles de una cuenta. La verificación queda
`pending`, salvo que la cuenta ya estuviera verificada al reemplazar el
documento; en ese caso conserva `completed`. `document_errors` indica
qué archivos debe reemplazar el comercio. Si la cuenta está conectada,
la plataforma recibe además `connected: true` y el `account_id` de la
cuenta hija.

## Payload

- VerificationRejectedWebhook
  - `event_type` string, required — Tipo exacto del evento enviado por Recurrente.
  - `connected` boolean, nullable — Presente como `true` cuando el evento proviene de una cuenta conectada.
  - `account_id` string, nullable — ID de la cuenta conectada que originó el evento.
  - `account` ConnectedAccount, required
    - `id` string — ID único de la cuenta conectada
    - `status` string — Estado de la cuenta
    - `name` string — Nombre comercial de la cuenta
    - `account_type` 'business' | 'individual' | 'non_profit' — Tipo de cuenta de negocio
    - `created_at` string, date-time — Fecha de creación
    - `creator_name` string — Nombre del usuario creador
    - `creator_email` string, email — Email del usuario creador
    - `tax_id` string, nullable — ID fiscal de la cuenta
    - `tax_name` string, nullable — Nombre fiscal de la cuenta
    - `withdrawals_schedule` 'daily' | 'manual' | 'instant' — Frecuencia configurada para retiros
    - `onboarding_completed` boolean — Indica si la cuenta completó onboarding
  - `status` 'pending' | 'completed', required — Estado de la verificación al rechazarse el documento.
  - `document_errors` object, required — Errores por nombre de documento rechazado.
  - `api_version` string, required
  - `created_at` string, date-time, required — Fecha de creación de la verificación.
  - `live_mode` boolean, required

## Acknowledgement `200`

Webhook received successfully

---

[API](https://skmtc.dev/recurrente/apis/referencia-api.md) · [All operations](https://skmtc.dev/recurrente/apis/referencia-api/llms.txt) · [OpenAPI document](https://skmtc-service-production.skmtc.workers.dev/v1/apis/recurrente/referencia-api/revisions/da12dce50f30/schema)
