# Transactions

Transaction Management - Create and manage transactions in the HG.Cash system. All transaction endpoints require authentication.

## Create Transaction Request

 - [POST /transactions](https://docs.hg.cash/openapi/transactions/createtransactionrequest.md): Create a new transaction request from one of your accounts. This does not perform an on-chain/bank transfer. An admin will process it. You may provide a webhookUrl to receive status updates.

## 📝 Required Fields

- accountId: Your account ID to debit from
- toCBU or toCVU: Recipient bank CBU/CVU (22 digits)
- amount: Positive decimal number
- Optional webhookUrl: URL to receive status updates

## 🔍 Validation Rules

- Account must belong to the authenticated user
- CBU must be a valid 22-digit number
- Optional externalID must be unique per account if provided

## Get Transaction Request Status

 - [GET /transaction/{id}/status](https://docs.hg.cash/openapi/transactions/gettransactionrequeststatus.md): Retrieve the status of a transaction request created via /transactions.
Requires the bearer token of the user that created the request.

## Get User Accounts

 - [GET /accounts](https://docs.hg.cash/openapi/transactions/getuseraccounts.md): Returns the authenticated user's accounts.

## Get Account Balance

 - [GET /account/{id}/balance](https://docs.hg.cash/openapi/transactions/getaccountbalance.md): Returns the balance for the authenticated user's account by ID.