Ver un ingreso
Detalle de un pago. Un id que no sea de un negocio de esta llave devuelve 404, no 403: responder «no tienes permiso» confirmaría que ese id existe.
Autorización
apiKey incomes.readLa 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: incomes.read
Parámetros de la ruta
Parámetros de consulta
Sobre qué negocio actúa la petición. Obligatorio solo si la llave entra a varios negocios (plan Multi); con uno solo, se deduce.
Cuerpo de la respuesta
application/json
application/json
application/json
application/json
curl -X GET "https://example.com/incomes/cmtmf1k8m006faqw1lh27ozcr"{ "object": "income", "id": "cmtmf1k8m006faqw1lh27ozcr", "amount": 45000, "currency": "COP", "status": "VERIFIED", "origin": "WHATSAPP", "occurredAt": "2026-09-04T20:04:05.000Z", "createdAt": "2026-09-04T20:04:12.311Z", "verifiedAt": "2026-09-04T20:05:41.902Z", "reference": "M1A2B3C4", "customerName": "Juan Pérez", "bankLabel": "Bancolombia", "accountLabel": "Nequi *4821", "duplicateOfId": null, "branch": { "id": "cmt7xbfrj0002q3w1iq4ysatr", "name": "Principal" }, "confirmedBy": { "id": "cmt8u1p9r00035pw1kq0v2xdc", "name": "Laura Gómez", "phone": "+573001112233" }, "attachments": [ { "id": "cmtmf1kax006haqw1r3vv9y2p", "contentType": "image/jpeg", "originalName": "comprobante.jpg", "size": 84213 } ], "bankChannels": [ "EMAIL" ]}Eliminar un ingreso declarado DELETE
Solo ingresos DECLARED. Borra también sus comprobantes del almacenamiento.
Listar ingresos GET
Lista los pagos del negocio, del más reciente al más antiguo, paginada por cursor. Acepta los mismos filtros que el panel: si el reporte que descarga el dueño y lo que lee tu integración salieran de filtros distintos, dirían cosas distintas del mismo mes.