Venflow API
V1Payment linksPor ID

Obtener un payment link

GET
/v1/payment-links/{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/payment-links/497f6eca-6276-4993-bfeb-53cbbbba6f08"
{
  "active": true,
  "allow_manual_payments": true,
  "apply_discount_to_additional_items": true,
  "collection_mode": "engine",
  "created": 0.1,
  "discount_id": "string",
  "expiration_hours": 0.1,
  "external_initial_charge": true,
  "id": "string",
  "items": [
    {
      "id": "string",
      "name": "string",
      "plan_id": "string",
      "price": 0.1,
      "product_id": "string",
      "quantity": 0.1
    }
  ],
  "livemode": true,
  "metadata": {
    "property1": "string",
    "property2": "string"
  },
  "object": "payment_link",
  "plan": "string",
  "redirect_url": "string",
  "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 un payment link POST

Crea un link de pago reutilizable: cada visita genera una sesión de checkout nueva, así que sirve para cobrarle a muchos clientes con un solo link. - Acepta planes recurrentes (cada visita crea una suscripción) y planes de pago único (cobra una sola vez, sin suscripción). - `items` admite **solo items de producto** (`type: "product"` con `product_id` y `plan_id`). Los items ad-hoc son una capacidad de las sesiones de checkout. - `discount_id` debe ser un descuento de tu organización; si no lo es, la respuesta es 404. - Con `active: false` el link nace apagado, útil para prepararlo antes de publicarlo. En un plan de **pago único** aplican además estas reglas, y el link se rechaza con 400 si no se cumplen: - Los items adicionales deben ser de planes de pago único: no se pueden mezclar con recurrentes. - No se admiten días de prueba (`trial_days` mayor que 0). - `allow_manual_payments` debe quedar en `true`: Débito Inmediato es el único medio de pago de un pago único. Crea un link de pago reutilizable: cada visita genera una sesión de checkout nueva, por lo que sirve para cobrarle a muchos clientes con un solo link. Acepta planes recurrentes (crea suscripciones) y planes de pago único (cobra una sola vez, sin suscripción).

Actualizar un payment link PATCH

Activa o desactiva un payment link. Es el interruptor de apagado: los payment links no se eliminan. - Un link desactivado rechaza cualquier visita nueva y deja de generar sesiones. - Los pagos, facturas y suscripciones que ya se generaron con él no se ven afectados. - Repetir el mismo valor no produce error. Activa o desactiva un payment link. Los payment links no se eliminan: al desactivarlos dejan de generar sesiones y cualquier visita al link es rechazada, sin afectar los pagos ni las suscripciones que ya se hicieron con él. Volver a activarlo lo deja operativo de nuevo, y repetir el mismo valor no produce error.