Get Wallet Transaction By Id

GET /wallet/transactions/:id

Retrieve detailed information about a single transaction for the authenticated user.

---

Authentication

All requests require an API key in the x-api-key header:

x-api-key: YOUR_API_KEY

---

Path Parameters

Field	Type	Required	Description
id	string	Yes	MongoDB Transaction ID

---

Example Request (cURL)

curl -X GET "https://api.kira-pay.com/wallet/transactions/64abc123def456789012349" \ -H "x-api-key: YOUR_API_KEY"

---

Example Response (200)

{ "_id": "64abc123def456789012349", "status": "completed", "txHash": "0x1234567890abcdef1234567890abcdef12345678", "protocol": "base", "summary": { "sender": "0x123...", "recipient": "0x8356D265646a397b2Dacf0e05A4973E7676597f4" }, "tokenIn": { "chainId": 8453, "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "decimals": 6, "amount": "100000000" }, "tokenOut": { "chainId": 8453, "address": "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913", "symbol": "USDC", "decimals": 6, "amount": "100000000" }, "price": 100, "settlementAmount": "99.5", "fee": "0.5", "feePercent": 0.5, "link": { "_id": "64abc123def456789012345", "code": "abc123xyz7", "customOrderId": "ORDER-123456", "name": "Payment for Order #123" }, "refundStatus": "not_refunded", "createdAt": "2024-01-15T12:20:00.000Z", "updatedAt": "2024-01-15T12:25:00.000Z" }

---

Response Fields

Field	Type	Description
_id	string	Transaction ID
status	string	Transaction status
txHash	string	Blockchain transaction hash
protocol	string	Blockchain / protocol (e.g. base)
summary.sender	string	Sender wallet
summary.recipient	string	Recipient wallet
tokenIn	object	Token paid by user
tokenOut	object	Token received by merchant
price	number	Price in fiat terms
settlementAmount	string	Final settled amount
fee	string	Fee amount
feePercent	number	Fee percentage
link	object	Link metadata (code, customOrderId, name)
refundStatus	string	Refund state
createdAt	string	ISO timestamp of creation
updatedAt	string	ISO timestamp of last update

---

Error Response

404 – Transaction not found

---

Usage Example

• Use this endpoint to show transaction detail views in admin dashboards or user receipts.

• Useful for support and reconciliation workflows.