Guides/Payment flows
Reconciliation
Match KyvoPay ledger entries with orders and financial records every day.
Reconciliation proves that operational records and financial movements agree.
What to store
For each operation, persist your internal id, idempotency key, KyvoPay public id, gross amount, fees, net amount, status and timestamps.
Daily process
Fetch statement pages for the target period, match entries by public id, verify amounts and classify unmatched or duplicated records for review.
Do not calculate from webhooks alone
Webhooks drive real-time state, while the ledger is the accounting source for balance changes. Use both: webhooks for operations and the statement for financial reconciliation.
Tip
Make the reconciliation job repeatable. Running the same date range again should update existing records, not create duplicates.