A statement is a CSV file listing the movements on your wallets between two dates, with the balance before and after each one. Use it to reconcile.

Request a statement

Request statements in the dashboard, on the Statements page. Choose what to include and the date range.
An API key cannot request a statement. It can list and download the ones you have requested.
Payve builds the file in the background. A statement moves through these statuses:

List statements

GET /v1/statements
This list uses limit (default 20) and offset, not a cursor. total is the number of statements on this page. GET /v1/statements/{id} returns one statement.

Download a statement

GET /v1/statements/{id}/download returns the file as text/csv.
A statement that is not completed yet returns 404 with the message Statement not ready yet. Wait and try again.

The file

Amounts in the CSV are in major units with decimals (50000.00), not minor units. This is the one place Payve does not use minor units. Convert before you compare a statement with API amounts.

Reconcile with it

1

Request yesterday's statement each morning

Choose type all.
2

Match every row to your own records

Match on Reference. Each of your payouts, pay-ins and conversions should have its rows, and each row should match something you know about.
3

Check the running balance

Each row’s Balance After should equal the next row’s Balance Before in the same currency.
4

Investigate anything unmatched

Fetch the transaction through the API, then contact support with its public id if it still does not add up.

When it fails