Venflow API
V1CobrosPor ID

Cancelar un cobro

DELETE
/v1/charges/{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 DELETE "https://api.venflow.app/v1/charges/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "amount": 0.1,
  "charge_date": "string",
  "created": 0.1,
  "currency": "USD",
  "failure_reason": "string",
  "id": "string",
  "invoice": "string",
  "livemode": true,
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "object": "charge",
  "payment": "string",
  "retry_policy": "none",
  "status": "scheduled",
  "subscription": "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"
}

Obtener un cobro GET

Obtiene una solicitud de cobro con su estado actual. Cuando el cobro ya se ejecutó, la respuesta incluye la factura y el pago que generó; cuando falló o se canceló, incluye el motivo en `failure_reason`.

Crear una sesión de Checkout POST

Crea una sesión de checkout para una suscripción o para un pago único. - Puedes aplicar un descuento con `discount_id`. Si el plan tiene un descuento por defecto, se aplica automáticamente aunque no envíes `discount_id` (el descuento de la sesión tiene prioridad sobre el del plan). - `apply_discount_to_additional_items` controla si el descuento también afecta a los items adicionales, además del plan base. - La respuesta incluye `amount_subtotal`, `amount_discount` (vista previa del primer ciclo, antes de impuestos), `amount_total` y el objeto `discount` aplicado. - **Planes por uso (`usage_type: metered`)**: la sesión muestra `amount_subtotal` y `amount_total` en `0` — no se cobra nada al momento del checkout. El cliente registra su método de pago, la suscripción se activa sin factura inicial y el consumo se factura al cierre de cada período (en arrears). Crea una nueva sesión de checkout: una suscripción o un pago único, según el tipo de plan que envíes. Una sesión de checkout representa la sesión de tu cliente mientras completa el pago.