# Get Wallet Transactions Retrieve transaction history for a specific currency wallet. ## List Transactions ### Headers ### Path Parameters ### Query Parameters ### Response (200 OK) ```json { "success": true, "data": { "data": [ { "transactionId": "wtx_xxxxx", "type": "CREDIT", "amount": 1000, "balanceBefore": 249000, "balanceAfter": 250000, "description": "Payment received", "sourceType": "PAYMENT", "sourceTransactionId": "txn_xxxxx", "sourceOrderId": "ord_xxxxx", "status": "COMPLETED", "processedAt": "2024-01-15T10:30:00.000Z", "settlementDate": "2024-01-16T00:00:00.000Z", "currency": "USD", "feeAmount": 0, "grossAmount": 1000, "createdAt": "2024-01-15T10:30:00.000Z" } ], "pagination": { "page": 1, "limit": 20, "total": 500, "total_pages": 25, "has_next": true, "has_prev": false } } } ``` --- ## Important Note `GET /merchant/api/v1/wallet/{currency}/transactions/{transactionId}` is **not currently exposed** on the merchant wallet route surface. Use the list endpoint with filters/search. ## Transaction Types | Type | Description | |------|-------------| | `CREDIT` | Money added to wallet | | `DEBIT` | Money withdrawn from wallet | | `SETTLEMENT` | Settlement to bank account | | `COMMISSION` | Commission or fee | | `REFUND` | Refund processed | | `CHARGEBACK` | Chargeback deduction | ## Transaction Statuses | Status | Description | |--------|-------------| | `PENDING` | Transaction initiated, awaiting processing | | `PROCESSING` | Transaction being processed | | `COMPLETED` | Transaction completed | | `FAILED` | Transaction failed | | `REVERSED` | Transaction reversed | ## Examples ```bash # List wallet transactions curl -X GET "https://api.zenpayz.com/merchant/api/v1/wallet/USD/transactions?type=CREDIT&limit=50&page=1&search=txn_123" \ -H "Authorization: Bearer zp_test_xxxxx" \ -H "X-Timestamp: 2024-01-15T10:30:00.000Z" \ -H "X-Signature: a1b2c3d4e5f6..." \ -H "X-Secret-Salt: your_secret_salt" ``` ```javascript // SDK currently provides a filter-based wallet transactions API. // Use `currency` in filters to scope to one wallet. const result = await zenpays.wallet.listTransactions({ currency: 'USD', type: 'credit', limit: 50, page: 1, }); ```