Balances and ledger

Your ledger is the record of every value that has verifiably reached your destination. It lives in Useroutr’s database; blockchain transactions are the evidence behind each entry, and the ledger is the account.

Useroutr holds no funds for you. Your balance describes what has already settled to your own destination account.

One intent, one credit

A successful funding intent results in exactly one posted CREDIT. Unique constraints in the database enforce this, so a replayed webhook, a retried job or a repeated call can never post a second one, and reconciliation flags any drift.

Balances

One balance per asset, projected from posted entries.

const { data: balances } = await useroutr.balances.list("app_5c1e0a9f");

Ledger entries

Newest first, cursor paginated.

for await (const entry of useroutr.ledger.iterate("app_5c1e0a9f")) {
  if (entry.type === "CREDIT" && entry.status === "POSTED") {
    console.log(entry.amount, entry.asset, entry.funding_intent_id);
  }
}

Field	Values
`type`	`CREDIT`, `REFUND` or `ADJUSTMENT`
`direction`	`CREDIT` or `DEBIT`
`status`	`PENDING`, `POSTED` or `VOIDED`. Only `POSTED` counts.
`amount`	A decimal string in `asset`

Each entry links to the funding intent, payment, settlement or refund it came from. Entries are never edited: a correction is a new, compensating entry. Your application id is on useroutr.applications.current(), and in the dashboard under Settings → Application.

Get started

Accept payments

Concepts

After a payment

Integrate

Balances and ledger

One intent, one credit

Balances

Ledger entries

​One intent, one credit

​Balances

​Ledger entries

One intent, one credit

Balances

Ledger entries