Reabrir el cobro de una factura en revisión
Tu clave API privada (comienza con pvk_)
In: header
Tu ID de organización
In: header
Path Parameters
uuidHeader Parameters
Clave de idempotencia (OBLIGATORIA). Repetir la llamada con la misma clave no vuelve a reabrir el cobro y devuelve la factura como está en ese momento. La clave es única por organización; reutilizarla con otros datos devuelve un error que nombra el campo distinto
Motivo por el que se reabre el cobro (OBLIGATORIO), por ejemplo cómo confirmaste que el cobro anterior no se hizo. Queda en el historial de la factura. Máximo 500 caracteres
1 <= length <= 500Response Body
application/json
application/json
application/json
application/json
application/json
application/json
application/json
curl -X POST "https://api.venflow.app/v1/invoices/497f6eca-6276-4993-bfeb-53cbbbba6f08/mark_open" \ -H "Idempotency-Key: string" \ -H "Content-Type: application/json" \ -d '{ "reason": "string" }'{
"amount_discount": 0.1,
"amount_due": 0.1,
"amount_paid": 0.1,
"amount_remaining": 0.1,
"amount_tax": 0,
"amount_taxable": 0,
"bank_reference": "string",
"created": 0.1,
"customer": "string",
"customer_email": "string",
"customer_name": "string",
"due_date": 0,
"exchange_rate": "string",
"id": "string",
"livemode": true,
"metadata": {
"property1": "string",
"property2": "string"
},
"number": "string",
"object": "invoice",
"paid": true,
"period_end": 0,
"period_start": 0,
"receipt_number": "string",
"status": "draft",
"subscription": "string",
"subtotal": 0.1,
"total": 0.1,
"total_usd": 0,
"under_review": true
}{
"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"
}{
"code": "not_found",
"details": {},
"message": "string"
}Anular una factura POST
Deja la factura sin efecto: Venflow no la cobra y deja de contarla como deuda de tu cliente. No cancela la suscripción: eso es una llamada aparte al API de suscripciones. Solo es válido si la factura está `open`, incluidas las que están en revisión con el banco (`under_review: true`). Si ya está `paid`, `uncollectible` o `void`, o su estado cambió mientras tanto, responde con un error de precondición: consulta la factura antes de decidir. Anular una factura en revisión no cancela el cobro pendiente. El banco aún no ha confirmado si ese débito se realizó; si lo confirma después, el pago quedará asociado a una factura anulada. Por eso, sobre una factura en revisión, la llamada responde con un error de precondición y no aplica cambios, a menos que envíes `confirm_under_review: true`. Te recomendamos confirmarlo solo después de verificar con tu cliente o con tu banco que el cobro no se realizó. `reason` es obligatorio y queda en el historial de la factura. Al anularla se envía el webhook `INVOICE_UPDATE_EVENT` con `invoice.status` en `cancelled`. Requiere el header `Idempotency-Key`. Repetir la llamada con la misma clave no vuelve a aplicar la acción: devuelve la factura como está en ese momento.
Listar todos los payment links GET
Lista los payment links de tu organización, los más recientes primero, incluidos los desactivados. - Cuando `has_more` es `true`, pide la página siguiente con `starting_after` igual al `id` del último elemento que recibiste. - Los payment links no se eliminan, así que `starting_after` es la única forma de llegar a los más antiguos. Devuelve la lista de payment links de tu organización, ordenados por fecha de creación con los más recientes primero. Incluye los links desactivados, para que puedas ver cuáles apagaste. Incluye links de planes recurrentes y de pago único. Cuando `has_more` es true, pedí la página siguiente con `starting_after` igual al id del último elemento.