Venflow API
V1DescuentosPor ID

Obtener un single Descuento by Por ID

GET
/v1/discounts/{id}

Authorization

Api-Key<token>

Tu clave API privada (comienza con pvk_)

In: header

Organization<token>

Tu ID de organización

In: header

Path Parameters

idstring
Formatuuid

Response Body

application/json

application/json

application/json

application/json

application/json

application/json

curl -X GET "https://api.venflow.app/v1/discounts/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "active": true,
  "amount_off": 0,
  "created": 0.1,
  "duration": "once",
  "duration_periods": 0,
  "id": "string",
  "livemode": true,
  "name": "string",
  "object": "discount",
  "percent_off": 0
}
{
  "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"
}

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`.

Actualizar un Descuento PATCH

Actualiza un descuento. Aplican las mismas reglas que al crear: - Nunca ambos `percent_off` y `amount_off`. Cambiar de un tipo al otro borra el anterior automáticamente. - `amount_off` está en **USD**. - Pasar a `duration: repeating` requiere `duration_periods`.