Skip to main content
PUT
/
invoices
/
{invoice}
Actualizar factura
curl --request PUT \
  --url https://api.onepay.la/v1/invoices/{invoice} \
  --header 'Authorization: Bearer <token>' \
  --header 'Content-Type: application/json' \
  --data '{
  "reference": "<string>",
  "provider_id": "<string>",
  "amount": 123,
  "name": "<string>",
  "phone": "<string>",
  "email": "<string>"
}'
{
  "id": "2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a",
  "name": "Internet plan - Actualizado",
  "provider": "WISPRO",
  "provider_id": "987654",
  "reference": "INV-12345678",
  "status": "CREATED",
  "remarks": null,
  "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"
  }
}

Path params

invoice
string
required
UUID de la factura a actualizar.

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.
phone
string
Número de teléfono del cliente en formato E.164. Opcional.
email
string
Correo electrónico del cliente. Opcional.

Response

{
  "id": "2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a",
  "name": "Internet plan - Actualizado",
  "provider": "WISPRO",
  "provider_id": "987654",
  "reference": "INV-12345678",
  "status": "CREATED",
  "remarks": null,
  "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"
  }
}
I