Overview

A settlement is the payout Walley makes to you, together with the report that explains it. The report lists every purchase, return, adjustment and fee for the period, so you can match the money in your bank account against the orders in your own system.

Getting the data

🔎 Reports API

Find your settlements, read the transactions on each one and download the PDF. Best fit when you want the data in your ERP or accounting system.

📊 Merchant Hub

Download the PDF and CSV files by hand. Filter by period, payout date, currency, reference and store. No integration needed.

🔔 Settlement webhook

Subscribe to walley:settlement:created and let Walley tell you the moment a new settlement is ready to fetch.

Start here

1. How settlements work explains what moves a payout up or down, how often you are settled, and what the PDF and CSV files contain.
2. Endpoints lists the test and production base URIs.
3. Authentication walks through the OAuth2 client credentials flow. You create the API key in Merchant Hub.
4. Settlement search returns your settlements and the ID you need for every other call.