mirror of
https://github.com/hanzo-fi/payments.git
synced 2026-10-30 20:31:20 +00:00
* Move all public connectors to ce/plugins * Update tooling to account for new go modules under ce * Ensure we test all CE plugins in CI * Move Dummypay to ce/plugins for simplicity's sake in the generation scripts * Use versioned pkg/domain in plugins * Ensure that renovate updates all CE plugins in a single PR when pkg/domain tags are pushed to github * Ensure Justfile commands work over all CE plugins * Copy ce plugin go.mods in dev.Dockerfile * Only add a go.mod for new plugins if they are ce * Ensure generated generic client structs are named correctly for submodule * Add coverprofile for each ce plugin * Add set -e for Justfile for loops over plugins * Infer go version from flake.nix in connector template tool
1.2 KiB
1.2 KiB
Balance
An account balance for a specific currency/asset.
Properties
| Name | Type | Description | Required |
|---|---|---|---|
| Amount | string | Balance amount in minor units (integer string, e.g., "10000" for $100.00) | ✅ |
| Currency | string | Asset in UMN format (e.g., "USD/2", "BTC/8", "EUR/2") | ✅ |
Example
{
"amount": "1000000",
"currency": "USD/2"
}
This represents a balance of $10,000.00 USD.
Multi-Currency Account Example
An account can have multiple balances in different currencies:
{
"id": "bal_123",
"accountID": "acc_001",
"at": "2026-01-14T15:00:00Z",
"balances": [
{ "amount": "1000000", "currency": "USD/2" },
{ "amount": "500000", "currency": "EUR/2" },
{ "amount": "10000000", "currency": "BTC/8" }
]
}
Amount Conversion
| Currency | Amount String | Human Readable |
|---|---|---|
| USD/2 | "10000" | $100.00 |
| EUR/2 | "5000" | €50.00 |
| BTC/8 | "100000000" | 1.00000000 BTC |
| JPY/0 | "1000" | ¥1000 |