📊 Reports & Reconciliation

Reports & Reconciliation

Financial reporting and account reconciliation

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

ReportDescriptionBest For
Ledger StatementBank-style statement with opening/closing balances and running balanceMonthly reconciliation, balance verification
Orders ReportTransaction-level view of all orders with filteringOrder analysis, status tracking, volume reporting
Ledger Entry DetailsDetailed receipt for a single ledger movementAudit 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:

  1. Pull ledger statement for the month
  2. Compare opening balance with previous month’s closing
  3. Verify each movement against your records
  4. Confirm closing balance matches current account balance

Transaction Volume Analysis

Use the Orders Report to analyze your payment activity:

  1. Pull orders report for the period
  2. Use summary statistics to see totals by type (PAYIN, PAYOUT, etc.)
  3. Filter by status to identify failed or pending transactions
  4. Export for business intelligence dashboards

Audit Documentation

Use Ledger Entry Details to generate proof of specific transactions:

  1. Identify the transaction in your ledger statement
  2. Retrieve the ledgerEntryId
  3. Pull detailed receipt with balance before/after
  4. Archive for compliance records

API Hierarchy

All report endpoints follow the same hierarchy:

/api/v1/organizations/{organizationId}/merchants/{merchantId}/accounts/{accountId}/reports/...
ParameterDescriptionExample
organizationIdYour organization IDorg3_8821b7b4-7f0c-45d9-aa5f-a9ce41ee2f1e
merchantIdThe merchant IDmrc_2e8f96ab-dbd5-45f9-b4b6-645945daf340
accountIdThe virtual account IDacc_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

Ledger Statement

Bank-style account statement with running balances

Orders Report

Transaction-level order reporting with filters

Ledger Entry Details

Detailed receipt for individual transactions