Venflow API
V1CheckoutSesionesPor ID

Obtener una sesión de Checkout

GET
/v1/checkout/sessions/{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/checkout/sessions/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "amount_discount": 0.1,
  "amount_subtotal": 0.1,
  "amount_total": 0.1,
  "collection_mode": "engine",
  "customer": "string",
  "discount": {
    "amount_off": 0,
    "duration": "once",
    "duration_periods": 0,
    "id": "string",
    "name": "string",
    "percent_off": 0
  },
  "expires_at": 0.1,
  "external_initial_charge": true,
  "id": "string",
  "livemode": true,
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "object": "checkout.session",
  "plan": {
    "amount": 0.1,
    "id": "string",
    "name": "string"
  },
  "redirect_url": "string",
  "scheduled_start_date": "string",
  "status": "pending",
  "trial_days": 0,
  "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"
}

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.

Listar todos los clientes GET

Devuelve una lista de tus clientes. Los clientes se devuelven ordenados por fecha de creación, con los más recientes primero.