---
id: overview
title: "Overview"
sidebar_label: Overview
hide_title: true
description: "Overview of Walley settlements and the Reports API"
---

import Ingress from "../../src/components/ingress/ingress.react";
import Link from "@docusaurus/Link";

<Ingress title="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.
</Ingress>

## Getting the data

<div className="overview-cards">
  <Link className="overview-card" to="/docs/reports/settlements-api/search">
    <h3>🔎 Reports API</h3>
    <p>
      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.
    </p>
  </Link>
  <Link className="overview-card" to="/docs/merchanthub/reports/overview">
    <h3>📊 Merchant Hub</h3>
    <p>
      Download the PDF and CSV files by hand. Filter by period, payout date,
      currency, reference and store. No integration needed.
    </p>
  </Link>
  <Link className="overview-card" to="/docs/webhooks/settlements">
    <h3>🔔 Settlement webhook</h3>
    <p>
      Subscribe to <code>walley:settlement:created</code> and let Walley tell you
      the moment a new settlement is ready to fetch.
    </p>
  </Link>
</div>

## Start here

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