Referencia
Una tarjeta que un cliente autorizó y que puedes volver a cobrar.
/v1/instrumentsLas tarjetas activas del entorno, hasta 100, de la más nueva a la más vieja.
/v1/instruments/{id}Una tarjeta, con su detalle completo.
| 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
curl "https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/instruments" \
-H "Authorization: Bearer sk_test_…"Respuesta 200
{
"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"
}
]
}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.
/v1/bins/{bin}De 6 a 8 dígitos. Dice qué producto es la tarjeta antes de cobrarla.
Consultar
curl "https://gxxazsplhgyezwxghrnn.supabase.co/functions/v1/blink-api/v1/bins/518617" \
-H "Authorization: Bearer sk_test_…"Respuesta 200
{
"object": "bin",
"bin_number": "518617",
"brand": "MASTERCARD",
"product": "CREDIT",
"product_type": "…",
"country": "CO",
"region": "LATAM",
"issuer": "…",
"supports_installments": true
}Esta página en markdown: /docs/api/instrumentos.md · Toda la documentación: /docs/llms-full.txt