# API · Obtener un link de pago por id

> Consulta de un link de pago puntual por su id.

- kind: api-operation
- status: stable
- api_version: v1
- last_verified: 2026-08-29
- url: https://www.tilopay.com/developers/api/links-de-pago/payment-by-id

```http
GET /api/v1/getLinkPaymentById/{link_payment_id}/{api_key}
```

## Qué hace [#que-hace]

Devuelve un link de pago puntual. No lleva cuerpo: los datos van en la ruta.

## Autenticación [#autenticacion]

Requiere el token bearer del API en el header `Authorization` — ver [autenticación](/developers/api/autenticacion).

## Parámetros [#parametros]

Parámetros de ruta, en el orden en que aparecen en la URL:

<Param id="payment-by-id-parametro-link-payment-id" name="link_payment_id" type="string · path" required>
Id del link de pago a consultar.
</Param>

<Param id="payment-by-id-parametro-api-key" name="api_key" type="string · path" required>
Api Key del comercio.
</Param>

## Respuesta [#respuesta]

```json
{
  "type": "200",
  "message": "Success",
  "data": {
    "id": 1,
    "amount": "45.00",
    "currency": "USD",
    "reference": "Producto de prueba 1 TP-Shop",
    "url": "https://admin.tilopay.com/link/loNj8E2MA==",
    "callback_url": null,
    "description": "Lorem ipsum dolor sit amet, consectetur adipiscing elit, sed do eiusmod tempor incididunt ut labore et dolore magna aliqua.",
    "times_used": null,
    "picture": "https://storage.googleapis.com/tilo-uploads/items/51087219_.png",
    "create": "2022-10-24 08:45:14",
    "payments": []
  }
}
```

Para interpretar una respuesta que no es de éxito, ver [cómo leer una respuesta de error](/developers/api/procesos-operativos/errors).