Skip to main content
GET
/
invoices
/
{invoice}
Obtener factura
curl --request GET \
  --url https://api.onepay.la/v1/invoices/{invoice} \
  --header 'Authorization: Bearer <token>'
{
  "id": "2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a",
  "name": "Internet plan - Octubre",
  "provider": "WISPRO",
  "provider_id": "987654",
  "reference": "INV-12345678",
  "status": "CREATED",
  "remarks": null,
  "payment": {
    "id": "c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
    "title": "Internet plan - Octubre",
    "description": "Internet plan - Octubre",
    "currency": "COP",
    "amount": 50000,
    "amount_label": "50.000",
    "phone": "+573167591038",
    "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/c1f4b0aa",
    "redirect_url": null,
    "created_at": "2025-10-20T15:06:00Z"
  }
}

​
Path params

​
invoice
string
required
UUID de la factura.

​
Response

{
  "id": "2f2b1e5a-1a2b-4c33-8a18-5e9f3b9f4b1a",
  "name": "Internet plan - Octubre",
  "provider": "WISPRO",
  "provider_id": "987654",
  "reference": "INV-12345678",
  "status": "CREATED",
  "remarks": null,
  "payment": {
    "id": "c1f4b0aa-6a12-4471-8a3d-1a2b3c4d5e6f",
    "title": "Internet plan - Octubre",
    "description": "Internet plan - Octubre",
    "currency": "COP",
    "amount": 50000,
    "amount_label": "50.000",
    "phone": "+573167591038",
    "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/c1f4b0aa",
    "redirect_url": null,
    "created_at": "2025-10-20T15:06:00Z"
  }
}
Códigos de error
  • 401 Unauthorized: token ausente o inválido.
  • 403 Forbidden: compañía inactiva o sin permisos.
  • 404 Not Found: la factura no existe o pertenece a otra compañía.
⌘I