Skip to main content
PUT
/
invoices
/
{invoice_id}
curl https://api.onepay.la/v1/invoices/2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a \
  -X PUT \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "INV-12345678",
    "amount": 75000,
    "name": "Internet plan - Actualizado",
    "description": "Plan 100MB - facturación octubre",
    "email": "juan@example.com",
    "phone": "+573001234567",
    "provider_id": "987654",
    "due_date": "2026-10-31"
  }'

{
  "id": "2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a",
  "name": "Internet plan - Actualizado",
  "description": "Factura de internet actualizada para octubre 2025",
  "provider": "biller",
  "provider_id": "987654",
  "reference": "INV-12345678",
  "status": "CREATED",
  "remarks": null,
  "created_at": "2025-10-20T15:06:00Z",
  "updated_at": "2025-10-20T15:06:00Z",
  "metadata": {
    "key": "value"
  },
  "payment": {
    "id": "new-payment-id",
    "title": "Internet plan - Actualizado",
    "description": "Internet plan - Actualizado",
    "currency": "COP",
    "amount": 75000,
    "amount_label": "75.000",
    "phone": "+573167591039",
    "external_id": "987654",
    "allows": { "accounts": true, "cards": true, "card_extra": false, "realtime": false },
    "status": "pending",
    "is_test": false,
    "payment_link": "https://pay.onepay.test/p/new-payment-id",
    "redirect_url": null,
    "created_at": "2025-10-20T15:25:00Z"
  }
}
Facturas con pagos parciales: Si la factura tiene un Payment en estado partially_paid, actualizarla cancelará ese Payment (y perderá todos los abonos registrados) y creará uno nuevo sin configuración de pagos parciales. Solo actualiza facturas parcialmente pagadas si estás seguro de que quieres reiniciar el proceso de cobro.Si el Payment ya está approved, la actualización solo modifica los metadatos de la factura sin cancelar ni reemplazar el Payment.

​
Path params

​
invoice_id
string
required
ID de la factura a actualizar. Crear factura.

​
Body

​
reference
string
required
Referencia única de la factura dentro de tu compañía. Mínimo 5 y máximo 100 caracteres.
​
provider_id
string
Identificador opcional que asocias a tu proveedor externo.
​
amount
number
required
Monto de la factura en pesos (COP). Debe estar entre 5.000 y 100.000.000.
​
name
string
required
Nombre o concepto de la factura. Mínimo 5 y máximo 100 caracteres.
​
description
string
Descripción detallada de la factura. Se propaga al nuevo Payment generado. Mínimo 4 y máximo 2000 caracteres.
​
phone
string
Número de teléfono del cliente en formato E.164. Opcional.
​
email
string
Correo electrónico del cliente. Opcional. Máximo 200 caracteres.
​
due_date
string
Fecha de vencimiento de la factura en formato YYYY-MM-DD (ej. 2026-10-31). Opcional. Si se omite o se envía null, se conserva el due_date actual de la factura. El valor se propaga al nuevo Payment generado durante la actualización.
Si no envías due_date en la actualización, la factura conserva su fecha de vencimiento actual. Solo se modifica cuando envías un valor explícito.
curl https://api.onepay.la/v1/invoices/2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a \
  -X PUT \
  -H "Authorization: Bearer sk_test_xxx" \
  -H "Content-Type: application/json" \
  -d '{
    "reference": "INV-12345678",
    "amount": 75000,
    "name": "Internet plan - Actualizado",
    "description": "Plan 100MB - facturación octubre",
    "email": "juan@example.com",
    "phone": "+573001234567",
    "provider_id": "987654",
    "due_date": "2026-10-31"
  }'

​
Response

{
  "id": "2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a",
  "name": "Internet plan - Actualizado",
  "description": "Factura de internet actualizada para octubre 2025",
  "provider": "biller",
  "provider_id": "987654",
  "reference": "INV-12345678",
  "status": "CREATED",
  "remarks": null,
  "created_at": "2025-10-20T15:06:00Z",
  "updated_at": "2025-10-20T15:06:00Z",
  "metadata": {
    "key": "value"
  },
  "payment": {
    "id": "new-payment-id",
    "title": "Internet plan - Actualizado",
    "description": "Internet plan - Actualizado",
    "currency": "COP",
    "amount": 75000,
    "amount_label": "75.000",
    "phone": "+573167591039",
    "external_id": "987654",
    "allows": { "accounts": true, "cards": true, "card_extra": false, "realtime": false },
    "status": "pending",
    "is_test": false,
    "payment_link": "https://pay.onepay.test/p/new-payment-id",
    "redirect_url": null,
    "created_at": "2025-10-20T15:25:00Z"
  }
}