<!-- ZenPays documentation · https://docs.zenpayz.com/docs/api-reference/wallet -->

# Wallet

Manage wallet balances, transactions, ledger entries, commissions, and fees. Access via `zenpays.wallet`.

## Balance

### getBalance

<Tabs groupId="language">
  <TabItem value="javascript" label="JavaScript" default>

```typescript
const balance = await zenpays.wallet.getBalance('INR')
// Or get all: const balances = await zenpays.wallet.getBalance()
```

  </TabItem>
  <TabItem value="python" label="Python">

```python
balance = zenpays.wallet.get_balance("INR")
```

  </TabItem>
</Tabs>

---

### getAllBalances

```typescript
const balances = await zenpays.wallet.getAllBalances()
```

---

## Transactions

### listTransactions

<Tabs groupId="language">
  <TabItem value="javascript" label="JavaScript" default>

```typescript
const { data } = await zenpays.wallet.listTransactions({
  type: 'credit',
  from: '2024-01-01',
  limit: 50,
})
```

  </TabItem>
  <TabItem value="python" label="Python">

```python
result = zenpays.wallet.list_transactions({"type": "credit", "limit": 50})
```

  </TabItem>
</Tabs>

---

### getTransaction

```typescript
const txn = await zenpays.wallet.getTransaction('wtxn_xxx')
```

---

## Adjustments

### listAdjustments

```typescript
const adjustments = await zenpays.wallet.listAdjustments()
```

---

### createAdjustment

```typescript
const adjustment = await zenpays.wallet.createAdjustment({
  amount: 100,
  currency: 'INR',
  type: 'credit',
  reason: 'Manual adjustment',
})
```

---

## Ledger

### getLedgerEntries

```typescript
const entries = await zenpays.wallet.getLedgerEntries({
  account: 'merchant_balance',
  from: '2024-01-01',
  to: '2024-12-31',
  limit: 100,
})
```

---

### getLedgerBalances

```typescript
const balances = await zenpays.wallet.getLedgerBalances()
```

---

### getReserveBalances

```typescript
const reserves = await zenpays.wallet.getReserveBalances()
// Returns: [{ currency, reserved, available }]
```

---

### getDailyLedgerSummary

```typescript
const summary = await zenpays.wallet.getDailyLedgerSummary('2024-06-15')
// Returns: { date, totalDebits, totalCredits, netChange, byAccount }
```

---

### getLedgerAnalytics

```typescript
const analytics = await zenpays.wallet.getLedgerAnalytics('30d')
// Returns: { period, totalVolume, trend }
```

---

## Commissions

### getCommissions

```typescript
const commissions = await zenpays.wallet.getCommissions({
  from: '2024-01-01',
  to: '2024-12-31',
  type: 'payment',
})
```

---

### getCommissionAnalytics

```typescript
const analytics = await zenpays.wallet.getCommissionAnalytics('30d')
// Returns: { period, totalCommission, byType, trend }
```

---

## Fees

### calculateFees

```typescript
const fees = await zenpays.wallet.calculateFees({
  amount: 1000,
  currency: 'INR',
  type: 'payment',
})
```

---

### getFeeConfig

```typescript
const config = await zenpays.wallet.getFeeConfig()
// Returns: { paymentFees, payoutFees, refundFees, currency }
```
