Reports & Reconciliation
Koywe provides comprehensive reporting endpoints to help you track, reconcile, and audit all financial activity in your virtual accounts.
Why Reports Matter
Key Benefits:
- Reconciliation: Match your internal records with Koywe’s ledger
- Audit Trails: Maintain complete transaction history for compliance
- Accounting Integration: Export data for your accounting systems
- Customer Support: Quickly retrieve transaction details for inquiries
Available Reports
| Report | Description | Best For |
|---|---|---|
| Ledger Statement | Bank-style statement with opening/closing balances and running balance | Monthly reconciliation, balance verification |
| Orders Report | Transaction-level view of all orders with filtering | Order analysis, status tracking, volume reporting |
| Ledger Entry Details | Detailed receipt for a single ledger movement | Audit documentation, dispute resolution |
When to Use Which Report
Common Use Cases
Monthly Bank Reconciliation
Use the Ledger Statement to reconcile your virtual account balance with your internal records:
- Pull ledger statement for the month
- Compare opening balance with previous month’s closing
- Verify each movement against your records
- Confirm closing balance matches current account balance
Transaction Volume Analysis
Use the Orders Report to analyze your payment activity:
- Pull orders report for the period
- Use summary statistics to see totals by type (PAYIN, PAYOUT, etc.)
- Filter by status to identify failed or pending transactions
- Export for business intelligence dashboards
Audit Documentation
Use Ledger Entry Details to generate proof of specific transactions:
- Identify the transaction in your ledger statement
- Retrieve the
ledgerEntryId - Pull detailed receipt with balance before/after
- Archive for compliance records
API Hierarchy
All report endpoints follow the same hierarchy:
/api/v1/organizations/{organizationId}/merchants/{merchantId}/accounts/{accountId}/reports/...| Parameter | Description | Example |
|---|---|---|
organizationId | Your organization ID | org3_8821b7b4-7f0c-45d9-aa5f-a9ce41ee2f1e |
merchantId | The merchant ID | mrc_2e8f96ab-dbd5-45f9-b4b6-645945daf340 |
accountId | The virtual account ID | acc_0031c537-2301-40ab-9153-0f7c48505350 |
Reports are scoped to a specific virtual account. Each account has its own ledger and transaction history.
Authentication
All report endpoints require a valid Bearer token:
curl -X GET 'https://api.koywe.com/api/v1/organizations/.../reports/ledger-statement' \
-H 'Authorization: Bearer YOUR_TOKEN'Next Steps
Last updated on