Ledger API
PRIMEROS PASOS
Autenticación
Idempotencia
CUENTAS
GETListar cuentas
POSTCrear una transferencia
GETConsultar una transferencia
DELAnular una transferencia
WEBHOOKS
Eventos
Firmas
Crear una transferencia
Mueve fondos entre dos cuentas tuyas. Las transferencias son atómicas e idempotentes: repetir la misma clave devuelve la transferencia original en lugar de crear una segunda.
POST/v1/transfersRequiere transfers:write
PARÁMETROS DEL CUERPO
fromobligatorioId de la cuenta de origen. Debe estar abierta y no bloqueada.
toobligatorioId de la cuenta de destino, en la misma moneda.
amountobligatorioUnidades menores, como entero. 1250 son 12,50 €.
referenceHasta 35 caracteres, visible en ambos extractos.
curlnodepython
curl https://api.ledger.dev/v1/transfers \
-H "Authorization: Bearer $KEY" \
-H "Idempotency-Key: 9f2c-41" \
-d from=acc_18fj2 \
-d to=acc_7ba91 \
-d amount=1250Enviar petición de prueba200 OK402409
// enviando…// esperando a api.ledger.dev
{ "id": "tr_3kQ82m", "status": "settled", "amount": 1250, "currency": "eur", "from": "acc_18fj2", "to": "acc_7ba91", "settled_at": "2026-09-06T18:04:11Z" }