# Reconciliation Guide

## Introduction

Our Reconciliation API helps you reconcile and match the payouts credited in your account and with the transactions
and refund operations they relate to.

Three endpoints are available to help you with your reconciliation:

* `GET Payout List`: will provide you with a list of all the payments credited into your payout account(s) by date.
* `GET Payment List`: will provide you with a list of all the `SUCCEEDED` transactions by Payout ID or by date range.
* `GET Refund List`: will provide you wirh a list of all the `SUCCEEDED` refunds by Payout ID or by date range.


Please note that all reconciliation data will only be made available on D+1 starting at 09:00CET. Recociliation
data is available in both PREPROD and PROD environements.

For the full endpoint documentation, please refer to the [Reconciliation API](/apis/merchant-reconciliation.openapi).

For more information on Payouts and Remittance Information, please refer to [this guide](/guides/general/payoutremittance052025).

## Get Payout List

This endpoint allows you to retrieve a list of all the payments credited into your payout account(s) by date.

### Path Parameters

| Name | Type | Required | Description |
|  --- | --- | --- | --- |
| `size` | Integer | No | The size of the page to be returned (Default is 10000). |
| `page` | Integer | No | Zero-based page index in list request (Default is 0). |
| `date` | String | No | The date for which the list of payouts should be returned. Format should be yyyy-MM-dd. (Default is current UTC date) |


### Response

### Error Codes

### Sample Request – `getPayoutList`

## Get Payment List

This endpoint allows you to retrieve a list of all all the `SUCCEEDED` transactions by Payout ID or by date range.

### Path Parameters

| Name | Type | Required | Description |
|  --- | --- | --- | --- |
| `size` | Integer | No | The size of the page to be returned (Defaul is 10000). |
| `page` | Integer | No | Zero-based page indew in list request (Default is 0). |
| `start-date` | String | No, unless `end-date` provided | The inclusive start date for the Payment list. Format should be yyyy-MM-dd. Maximum 30 days between `start-date` and `end-date` |
| `end-date` | String | No, unless `start-date` provided | The inclusive end date for the Payment list. Format should be yyyy-MM-dd. Maximum 30 days between `start-date` and `end-date` |
| `payout-id` | Integer | No | Unique payout identifier for which you wish to retrieve the Payment list. |


### Response

### Error Codes

### Sample Request – `getPayments`

## Get Refund List

This endpoint allows you to retrieve a list of all all the `SUCCEEDED` refunds by Payout ID or by date range.

### Path Parameters

| Name | Type | Required | Description |
|  --- | --- | --- | --- |
| `size` | Integer | No | The size of the page to be returned (Defaul is 10000). |
| `page` | Integer | No | Zero-based page indew in list request (Default is 0). |
| `start-date` | String | No, unless `end-date` provided | The inclusive start date for the Payment list. Format should be yyyy-MM-dd. Maximum 30 days between `start-date` and `end-date` |
| `end-date` | String | No, unless `start-date` provided | The inclusive end date for the Payment list. Format should be yyyy-MM-dd. Maximum 30 days between `start-date` and `end-date` |
| `payout-id` | Integer | No | Unique payout identifier for which you wish to retrieve the Payment list. |


### Response

### Error Codes

### Sample Request – `getRefunds`