Balances
Each wallet exposes an available balance (spendable now) and a pending balance (funds locked by in-flight payments). Funds are locked at authorization and only released on success or failure — the backend never lets a balance go negative.
Read a balance
curl https://sandbox.amnenpay.com/v1/wallets/wlt_1a2b3c/balance \ -H "Authorization: Bearer sk_test_51H8xExampleSandboxKeyOnly"
Endpoints
| Endpoint | Description |
|---|---|
GET /wallets | List the wallets on your account. |
POST /wallets | Create a wallet in a given currency. |
GET /wallets/{walletId}/balance | Read available and pending balances. |
GET /wallets/{walletId}/transactions | Paginated ledger of wallet movements. |
POST /wallets/{walletId}/transfer | Move funds to another wallet. Requires Idempotency-Key. |
POST /wallets/{walletId}/fund | Top up a wallet. Requires Idempotency-Key. |