Accounting & Reporting
Every settled invoice produces a transaction record in Coinsnap. These records contain the information you need for bookkeeping: the Bitcoin amount, the fiat equivalent at the time of payment, and the service fee charged.
How transactions work
When an invoice is paid and settled, Coinsnap creates a transaction record representing the deposit to your wallet. Each transaction has:
| Field | Description |
|---|---|
id | Transaction identifier |
invoiceId | The invoice this deposit belongs to |
type | transfer — standard deposit to your wallet |
status | Settled when funds have been sent |
amount | Net amount deposited to your wallet, in SATS |
fullAmount | Full payment amount before fees, in SATS |
feeAmount | Coinsnap service fee, in SATS |
amountInPreferredCurrency | Fiat equivalent at the time of settlement |
depositMethod | How funds were sent (e.g. Lightning) |
hash | Bitcoin or Lightning payment hash |
createdAt | Unix timestamp of the deposit |
The feeAmount is deducted from your prepaid wallet balance — not from the deposit itself. Your customer always pays the exact invoice amount and you receive the exact invoice amount.
Accessing transaction data
Dashboard
Go to Coinsnap Dashboard → Transactions to view all settled payments. The table shows each deposit with its invoice reference, amount, fiat equivalent, and date.
Export to CSV using the export button in the top right. The CSV includes all fields and is compatible with spreadsheet tools and most accounting software.
API
Retrieve transactions programmatically with optional date filtering:
# All transactions
curl 'https://app.coinsnap.io/api/v1/stores/YOUR_STORE_ID/transactions' \
-H 'x-api-key: YOUR_API_KEY'
# Filter by date range (ISO 8601 or Unix timestamp)
curl 'https://app.coinsnap.io/api/v1/stores/YOUR_STORE_ID/transactions?startDate=2025-01-01&endDate=2025-01-31' \
-H 'x-api-key: YOUR_API_KEY'
See API Reference → Transactions for the full response schema.
Exchange rates and fiat values
The exchange rate is locked at the moment the invoice is created. Each transaction record includes amountInPreferredCurrency — the fiat equivalent calculated at that locked rate.
This is the value to use for tax and VAT reporting: it reflects what the customer agreed to pay in fiat, converted to Bitcoin at a fixed rate. Because the rate is locked at invoice creation, the fiat value does not change after the fact regardless of Bitcoin price movements.
Service fees
Coinsnap charges a small percentage per settled invoice. Fees appear as a separate line in your transaction history with type: fee. The fee is deducted from your prepaid wallet balance — it does not reduce the amount received from the customer.
For bookkeeping purposes, treat fees as a payment processing cost, separate from revenue.