ReferenciaIdentidad

Plan y consumo

Plan actual, funciones incluidas, límites y verificaciones consumidas en el mes.

Sirve para que un bot pregunte «¿esta cuenta todavía puede verificar?» antes de pedirle la foto al cliente.

Autorización

apiKey plan.read

AutorizaciónBearer <token>

La llave del negocio, creada en el panel: Integraciones → API pública. vk_live_… es una llave real; vk_test_…, una llave de modo prueba (verificaciones simuladas, nada toca el libro real). Ver la guía «Modo de prueba».

Va en: header

Permiso: plan.read

Cuerpo de la respuesta

`application/json`

`application/json`

`application/json`

curl -X GET "https://example.com/plan"

{  "object": "plan",  "key": "TU_PLAN",  "name": "El nombre de tu plan",  "level": 20,  "status": "ACTIVE",  "features": {    "public_api": true,    "webhooks_outbound": true,    "mcp_server": true,    "expenses_module": true,    "receivables_module": false  },  "limits": {    "limit_verifications": 4000,    "limit_api_requests_per_minute": 120,    "retry_pending_minutes": 30  },  "enums": {    "report_frequency": "DAILY"  },  "usage": {    "verifications": {      "used": 312,      "limit": 4000,      "remaining": 3688    }  }}

Quién soy GET

Valida la llave y devuelve a qué negocios entra, qué permisos tiene y en qué plan está la cuenta. Es el request que conviene hacer primero en cualquier integración: si algo va a fallar por configuración, falla aquí y no a mitad del flujo.

Verificar un comprobante POST

Mandas la **imagen** del comprobante (`imageUrl` o `imageBase64`) y Verifika la lee con IA, busca duplicados, la cruza contra el aviso del banco del negocio y devuelve el veredicto con un `message` listo para reenviarle a quien pagó. - `201` `VERIFIED`: el banco ya había avisado. - `201` `PENDING`: registrado y esperando al banco (`AWAITING_BANK`) o a una persona (`AWAITING_REVIEW`). Cuando se resuelva llega el webhook `verification.verified` o `verification.not_found`, con tu `metadata`. - `200` `DUPLICATE` o `REJECTED`: no se registró nada y **no consume cupo**. Consume una verificación del cupo mensual solo cuando queda registrada. Si mandas `amount`, se usa el contrato de datos de siempre: no se lee la imagen y la respuesta es la forma anterior (`outcome`, `business`, `income`, `attachment`) más `verificationId` y `livemode`. Con una llave de prueba (`vk_test_`) la lectura con IA es real pero el veredicto es simulado (valores mágicos en `reference`) y nada toca el libro. Ver «Verifica desde tu propio bot» y «Modo de prueba».