VerifikaDocs
ReferenciaPagos sospechosos

Listar intentos sospechosos

Comprobantes repetidos y comprobantes que el banco nunca respaldó. No salen en /v1/incomes, y es a propósito: meterlos entre los ingresos inflaría el total del periodo que el negocio le manda a su contador.

GET
/suspicious-attempts

Autorización

apiKey suspicious.read
AutorizaciónBearer <token>

La llave del negocio, creada en el panel: Integraciones → API pública. Formato vk_live_… (o vk_test_… fuera de producción).

Va en: header

Permiso: suspicious.read

Parámetros de consulta

companyId?string

Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios (plan Multi); con uno solo, se deduce.

limit?integer

Filas por página.

Rango1 <= value <= 100
Por defecto50
startingAfter?string

Cursor: el nextCursor de la página anterior.

from?string
to?string
kind?array<>

Repetible.

attemptStatus?array<>

Repetible.

Cuerpo de la respuesta

application/json

application/json

application/json

application/json

curl -X GET "https://example.com/suspicious-attempts"
{  "object": "list",  "data": [    {      "object": "suspiciousAttempt",      "id": "string",      "kind": "DUPLICATE",      "status": "OPEN",      "channel": "WHATSAPP",      "amount": 0,      "reference": "string",      "customerName": "string",      "bankLabel": "string",      "accountLabel": "string",      "occurredAt": "string",      "createdAt": "string",      "originalIncomeId": "string"    }  ],  "hasMore": true,  "nextCursor": "string"}

Ver un intento sospechoso GET

Anterior

Estado de la conexión GET

Por dónde entran los avisos del banco y si el canal sigue vivo. healthy es el dato que importa: cuando se pone en false, el negocio dejó de tener con qué verificar y todavía no lo sabe. Un monitor que consulte esto cada mañana se entera antes que el cliente que reclama.