Venflow API
V1Descuentos

Listar Descuentos

GET
/v1/discounts

Authorization

Api-Key<token>

Tu clave API privada (comienza con pvk_)

In: header

Organization<token>

Tu ID de organización

In: header

Query Parameters

limit?integer

Limit on number of results (1–100, default 10)

Range1 <= value <= 100
starting_after?string

Cursor for pagination

Formatuuid
ending_before?string

Cursor for pagination

Formatuuid
active?boolean

Filter by active state

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.venflow.app/v1/discounts"
{
  "data": [
    {
      "active": true,
      "amount_off": 0,
      "created": 0.1,
      "duration": "once",
      "duration_periods": 0,
      "id": "string",
      "livemode": true,
      "name": "string",
      "object": "discount",
      "percent_off": 0
    }
  ],
  "has_more": true,
  "object": "list",
  "url": "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"
}
{
  "code": "not_found",
  "details": {},
  "message": "string"
}

Eliminar un cliente DELETE

Elimina permanentemente un cliente. Esta acción no se puede deshacer. También elimina inmediatamente la relación del cliente con tu organización.

Crear un Descuento POST

Crea un descuento para tu organización. - Especifica **exactamente uno** de `percent_off` o `amount_off`. Nunca ambos, y al menos uno es obligatorio. - `amount_off` es un monto en **USD** (los precios de la plataforma están en USD; los bolívares se calculan con la tasa BCV). Por eso el descuento no lleva moneda. - `duration` define por cuánto tiempo aplica: `once` (un solo ciclo de cobro), `forever` (todos los ciclos) o `repeating` (una cantidad fija de ciclos). - `duration_periods` son los **ciclos de cobro** en los que aplica el descuento. Solo es válido y obligatorio cuando `duration` es `repeating`; se ignora con `once` y `forever`.