Venflow API
V1Cobro basado en usoEventos

Registrar un evento de uso

POST
/v1/usage/events

Authorization

Api-Key<token>

Tu clave API privada (comienza con pvk_)

In: header

Organization<token>

Tu ID de organización

In: header

Request Body

customer_idstring

ID del cliente que generó el consumo

Length1 <= length
event_namestring

Nombre del evento, debe coincidir con el event_name del medidor

Length1 <= length
idempotency_keystring

Clave de idempotencia para evitar duplicados. Si enviás el mismo valor dos veces, el segundo evento es ignorado

Length1 <= length
subscription_idstring

ID de la suscripción asociada al consumo

Length1 <= length
timestampstring

Timestamp del evento en formato ISO 8601 (ej: "2026-05-28T14:30:00Z")

Length1 <= length
valuenumber

Valor numérico del consumo (unidades consumidas)

Formatdouble

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X POST "https://api.venflow.app/v1/usage/events" \  -H "Content-Type: application/json" \  -d '{    "event_name": "api_request",    "customer_id": "550e8400-e29b-41d4-a716-446655440000",    "subscription_id": "8f14e45f-ceea-467a-9c2b-3a1b2c3d4e5f",    "value": 100,    "timestamp": "2025-08-01T12:00:00Z",    "idempotency_key": "evt_2025_08_01_0001"  }'
{
  "accepted": true
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}

Resolver una domiciliación pendiente (solo sandbox) POST

Responde por el banco simulado: desde el siguiente intento del pagador, la domiciliación queda aprobada o rechazada. Es el complemento exploratorio de los valores de prueba — estos eligen el resultado antes de empezar, esto lo cambia con el checkout ya en curso. Solo funciona con una clave de prueba (`pvtk_`), que actúa sobre tu organización sandbox. Con una clave de producción la llamada se rechaza y no cambia nada.

Listar todos los medidores GET

Devuelve una lista de los medidores de uso de tu organización, ordenados por fecha de creación con los más recientes primero.