# Instrumentos

> Las tarjetas guardadas de tus clientes en Lane: cómo listarlas, qué trae cada una y cómo saber si admite cuotas.

Una tarjeta que un cliente autorizó y que puedes volver a cobrar.

### GET /v1/instruments

Las tarjetas activas del entorno, hasta 100, de la más nueva a la más vieja.

### GET /v1/instruments/{id}

Una tarjeta, con su detalle completo.

**El objeto**

| Campo | Tipo | Obligatorio | Descripción |
| --- | --- | --- | --- |
| `id` | UUID | no | El que mandas como `instrument_id` al cobrar. |
| `status` | texto | no | El listado solo trae las `active`. |
| `bin` | texto | no | Los primeros dígitos. Sirven para consultar el producto. |
| `last4` | texto | no | Para que el cliente reconozca cuál es. |
| `brand` | texto | no | `VISA`, `MASTERCARD`… |
| `product` | texto | no | `CREDIT` o `DEBIT`. |
| `supports_installments` | booleano | no | `true` solo si es crédito. |
| `customer` | objeto | no | De quién es. |
| `enrolled_at` | fecha | no | Cuándo la guardó. |

**Listar tarjetas**

```bash
curl "https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/instruments" \
  -H "Authorization: Bearer sk_test_…"
```

_Respuesta 200_

```json
{
  "object": "list",
  "data": [
    {
      "object": "payment.instrument",
      "id": "c1a9f3e0-…",
      "status": "active",
      "bin": "518617",
      "last4": "4242",
      "brand": "MASTERCARD",
      "product": "CREDIT",
      "supports_installments": true,
      "customer": { "email": "cliente@ejemplo.com" },
      "enrolled_at": "2026-09-06T18:20:11.000Z"
    }
  ]
}
```

> **Nota: No se actualizan solas.** Si al cliente le reemiten la tarjeta, el instrumento deja de servir y no hay forma de renovarlo por API: hay que pedirle que la inscriba de nuevo. Cómo se guardan y se cobran está en [Cobro recurrente](https://lane.money/docs/guias/cobro-recurrente).

## Consultar un BIN

### GET /v1/bins/{bin}

De 6 a 8 dígitos. Dice qué producto es la tarjeta antes de cobrarla.

**Consultar**

```bash
curl "https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/bins/518617" \
  -H "Authorization: Bearer sk_test_…"
```

_Respuesta 200_

```json
{
  "object": "bin",
  "bin_number": "518617",
  "brand": "MASTERCARD",
  "product": "CREDIT",
  "product_type": "…",
  "country": "CO",
  "region": "LATAM",
  "issuer": "…",
  "supports_installments": true
}
```