Payout & Reconciliation
Payouts
Payouts will be made to the bank account you specified in the Onboarding. The payout usually arrives within five business days, but usually within half a day. The payout will be made with the fees deducted already, i.e., the net amount will be paid out.
Payout Reports
You can use the Payout Report API to get a list of all payouts made to your bank account in a certain period. Payouts are made regularly, and the payout report will show you the associated orders, refunds, amount, and the date for one payout.
Create a Payout Report
To create a payout report, request the Create Payout Report endpoint. You must provide the intervalStart
and intervalEnd
fields in the request body as UNIX timestamps.
Example Request Payload
{
"intervalStart": 1638886400,
"intervalEnd": 1638972800
}
In the response, you receive the id
and the initial status
of the payout report. You can use this id
to retrieve the status later and download the payout report.
Example Response Payload
{
"id": "5f9b5f9b-5f9b-5f9b-5f9b-5f9b5f9b5f9b",
"status": "pending"
}
Poll for the report status
After you have created the payout report, the report is gathered asynchronously and usually takes around 30 seconds to be ready. You can poll the Retrieve Payout Report endpoint to get the current status of the payout report. You must provide the reportId
of the payout report in the request body.
Example Request Payload
{
"reportId": "5f9b5f9b-5f9b-5f9b-5f9b-5f9b5f9b5f9b"
}
As a response, you will receive the payout report's current status.
Example Response Payload
{
"status": "pending"
}
Download the report
The status will switch to ' succeeded ' as soon as the payout report is ready. Use the Download Payout Report endpoint to download the payout report. You need to provide the reportId
of the payout report in the request path and specify the format of the Download. You can receive the report in JSON format or as a CSV file.
Example Request Payload
{
"reportId": "5f9b5f9b-5f9b-5f9b-5f9b-5f9b5f9b5f9b",
"format": "json"
}
You will receive the report in the JSON response if you specify JSON as the format. The report will contain a list of all payouts made to your bank account. Each payout will have the id
of the payout, the availableAt
date, the amount
, and a list of all orders included in the payout.
Example Response Payload
{
"payouts": [
{
"id": "po_123456789",
"availableAt": 1638972800,
"amount": 1000.00,
"transactions": [
{
"orderId": "Shop-99999",
"gross": 1000.00,
"net": 900.00,
"fee": 100.00,
"currency": "EUR",
"reportingCategory": "charge",
"description": ""
}
]
}
]
}
If the report is not ready, you will receive a status400
response.
Updated 5 months ago