Quickstart

En 3 pasos tenés una integración funcionando.

Creá una API key

En FinUp, entrá a API Keys → Nueva API key, ponele un nombre, elegí el acceso (Solo lectura o Acceso total) y copiá la clave cuando se muestra. Ver Claves API.La clave tiene esta forma:

finup_xxxxxxxxxxxxxxxxxxxxxxxxxxxxxxxx

Hacé tu primera llamada

Pedí la lista de clientes del negocio:

curl --request GET \
  --url "https://api.finup.ar/api/clients" \
  --header "Authorization: Bearer $FINUP_API_KEY"

const res = await fetch("https://api.finup.ar/api/clients", {
  headers: { Authorization: `Bearer ${process.env.FINUP_API_KEY}` },
});
const data = await res.json();
console.log(data.clients, data.nextCursor);

import os, requests

res = requests.get(
    "https://api.finup.ar/api/clients",
    headers={"Authorization": f"Bearer {os.environ['FINUP_API_KEY']}"},
    timeout=30,
)
res.raise_for_status()
print(res.json()["clients"])

Respuesta:

{
  "clients": [
    {
      "id": "b1f2...",
      "first_name": "María",
      "last_name": "González",
      "dni": "30123456",
      "created_at": "2026-01-14T12:00:00.000Z"
    }
  ],
  "nextCursor": null
}

Creá un crédito (acceso total)

Con una clave de acceso total, otorgá un crédito a un cliente usando un plan activo:

curl --request POST \
  --url "https://api.finup.ar/api/clients/$CLIENT_ID/credits" \
  --header "Authorization: Bearer $FINUP_API_KEY" \
  --header "Content-Type: application/json" \
  --data '{ "amount": 300000, "credit_config_id": "CONFIG_UUID" }'

La respuesta incluye el crédito y sus cuotas:

{
  "credit": { "id": "…", "amount": 300000, "status": "active", "sequential_id": 1042 },
  "installments": [
    { "number": 1, "amount": 58500, "due_date": "2026-02-10", "status": "pending" }
  ]
}

Una clave de solo lectura que intente un POST recibe 403 { "error": "This API key only allows read access" }.

Flujos

Quickstart

Quickstart

Siguientes pasos

​Quickstart

​Siguientes pasos

Quickstart

Siguientes pasos