Depósitos

Aquí no se «crea» nada: un depósito lo inicia quien manda el dinero. Lo que la API te da es dónde mandarlo y qué ha llegado.

Por eso hay un solo alcance, deposits:read. No hay nada que escribir.

---

Una llamada, no cuatro

curl https://api.binkio.com/v1/deposit_instructions \
  -H "Authorization: Bearer bk_live_sec_…"

{
  "object": "list",
  "data": [
    {
      "object": "deposit_instruction",
      "rail": "spei",
      "asset": "MXNB",
      "currency": "MXN",
      "usable": true,
      "clabe": "000000000000000000",
      "bank_name": "Nvio"
    },
    {
      "object": "deposit_instruction",
      "rail": "crypto",
      "asset": "USDC",
      "currency": "USDC",
      "usable": true,
      "address": "0x9c8b7e1d3a5f6c2b0a9d8e7f6a5b4c3d2e1f0a9b",
      "network": "ETHEREUM"
    }
  ]
}

Todos los sitios donde te pueden pagar, con su riel. En el panel eso vive en cuatro pantallas; aquí es una respuesta.

Fíjate en asset y currency. En SPEI llegan pesos y se acreditan MXNB, 1:1. Son dos campos porque confundirlos es lo que hace que alguien mande el importe equivocado.

Mira usable antes de enseñar nada

Una vía recién aprovisionada puede seguir en trámite con el proveedor. Enseñársela a un pagador antes de tiempo pierde el dinero que mande.

:::danger La red importa tanto como la dirección En las instrucciones de cripto, network es la red exacta. La misma dirección puede aparecer en varias redes y mandar el activo por la que no es lo pierde para siempre.

Enséñala junto a la dirección. Siempre, aunque te parezca ruido visual. :::

Se pueden guardar

Estos datos son estables — la CLABE de una cuenta no cambia. Guárdalos, pero refréscalos cuando aparezca un activo nuevo.

Si operas una plataforma que da de alta comercios, esta llamada es la que te quita el paso manual por comercio.

---

Qué ha entrado

curl "https://api.binkio.com/v1/deposits?limit=25" \
  -H "Authorization: Bearer bk_live_sec_…"

Estado	Qué significa
processing	Llegó y se está confirmando
completed	Acreditado en tu saldo
failed	No se acreditó

processing no es un fallo: un depósito en cadena espera confirmaciones y uno por transferencia espera al banco.

Para enterarte en cuanto llega, suscríbete a deposit.completed en vez de sondear. → Webhooks

---

Lo que no trae, y por qué

No hay campo fee. Hoy los rieles de entrada no cobran, y la fila del depósito no guarda comisión: publicar un "0" fijo sería inventar un dato que dejaría de ser cierto el día que alguno empiece a cobrar, sin que nada avise. Lo que se cobró se ve en GET /v1/transactions.