Get settlement

Settlements API v2
GEThttps://api.mollie.com/v2/settlements/*id*
Authentication:OAuth access tokens

Successful payments are collected into settlements, which are then paid out according to your account’s payout schedule. By retrieving a single settlement, you can check which payments were paid out with it, when the settlement took place, and what invoice reference was used for it.

Settlements will be transferred to your bank account with a reference, for example 1182161.1506.02. You can use the List settlements endpoint to look up a settlement by reference.

Parameters

Replace id in the endpoint URL by the settlement’s ID, for example stl_jDk30akdN.

Response

200 application/hal+json; charset=utf-8

resource

string
Indicates the response contains a settlement object. Will always contain settlement for this endpoint.

id

string
The settlement’s unique identifier, for example stl_jDk30akdN.

reference

string
The settlement’s bank reference, as found on your invoice and in your Mollie account.

createdAt

string
The date on which the settlement was created, in ISO 8601 format.

settledAt

string
The date on which the settlement was settled, in ISO 8601 format. When requesting the open settlement or next settlement the return value is null.

status

string

The status of the settlement.

Possible values:

  • open The settlement has not been closed yet.
  • pending The settlement has been closed and is being processed.
  • paidout The settlement has been paid out.
  • failed The settlement could not be paid out.

amount

amount object

The total amount paid out with this settlement.

currency

string
The ISO 4217 currency code.

value

string
A string containing the exact amount of the settlement in the given currency.

periods

object

This object is a collection of Period objects, which describe the settlement by month in full detail.

Please note the periods are sorted by date. For example, the field may contain an object called 2018, which contains a Period object called 03. The Period object fields are listed below.

revenue

array

An array of revenue objects containing the total revenue for each payment method during this period. Each object has the following fields.

description

string
A description of the revenue subtotal.

amountNet

amount object
The net total of received funds for this payment method (excludes VAT).

amountVat

amount object
The VAT amount applicable to the revenue.

amountGross

amount object
The gross total of received funds for this payment method (includes VAT).

count

integer
The number of payments received for this payment method.

method

string
The payment method ID, if applicable.

costs

array

An array of Cost objects, describing the fees withheld for each payment method during this period. Each object has the following fields.

description

string
A description of the subtotal.

amountNet

amount object
The net total costs for this payment method (excludes VAT).

amountVat

amount object
The VAT amount applicable to the costs.

amountGross

amount object
The gross total costs for this payment method (includes VAT).

count

integer
The number of times costs were made for this payment method.

rate

object

The service rates, further divided into fixed and percentage costs.

fixed

amount object
An amount object describing the fixed costs.

variable

string
A string describing the variable costs as a percentage.

method

string
The payment method ID, if applicable.

_links

object

An object with several URL objects relevant to the settlement. Every URL object will contain an href and a type field.

self

URL object
The API resource URL of the settlement itself.

payments

URL object
The API resource URL of the payments that are included in this settlement.

refunds

URL object
The API resource URL of the refunds that are included in this settlement.

chargebacks

URL object
The API resource URL of the chargebacks that are included in this settlement.

documentation

URL object
The URL to the settlement retrieval endpoint documentation.

Example

Request

1
2
curl -X GET https://api.mollie.com/v2/settlements/stl_jDk30akdN \
    -H "Authorization: Bearer access_Wwvu7egPcJLLJ9Kb7J632x8wJ2zMeJ"

Response

  1
  2
  3
  4
  5
  6
  7
  8
  9
 10
 11
 12
 13
 14
 15
 16
 17
 18
 19
 20
 21
 22
 23
 24
 25
 26
 27
 28
 29
 30
 31
 32
 33
 34
 35
 36
 37
 38
 39
 40
 41
 42
 43
 44
 45
 46
 47
 48
 49
 50
 51
 52
 53
 54
 55
 56
 57
 58
 59
 60
 61
 62
 63
 64
 65
 66
 67
 68
 69
 70
 71
 72
 73
 74
 75
 76
 77
 78
 79
 80
 81
 82
 83
 84
 85
 86
 87
 88
 89
 90
 91
 92
 93
 94
 95
 96
 97
 98
 99
100
101
102
103
104
105
106
107
108
109
110
111
112
113
114
115
116
117
118
119
120
121
122
HTTP/1.1 200 OK
Content-Type: application/hal+json; charset=utf-8

{
    "resource": "settlement",
    "id": "stl_jDk30akdN",
    "reference": "1234567.1804.03",
    "createdDatetime": "2018-04-06T06:00:01.0Z",
    "settledDatetime": "2018-04-06T09:41:44.0Z",
    "amount": {
        "currency": "EUR",
        "value": "39.75"
    },
    "periods": {
        "2018": {
            "4": {
                "revenue": [
                    {
                        "description": "iDEAL",
                        "method": "ideal",
                        "count": 6,
                        "amountNet": {
                            "currency": "EUR",
                            "value": "86.1000"
                        },
                        "amountVat": null,
                        "amountGross": {
                            "currency": "EUR",
                            "value": "86.1000"
                        }
                    },
                    {
                        "description": "Refunds iDEAL",
                        "method": "refund",
                        "count": 2,
                        "amountNet": {
                            "currency": "EUR",
                            "value": "-43.2000"
                        },
                        "amountVat": null,
                        "amountGross": {
                            "currency": "EUR",
                            "value": "43.2000"
                        }
                    }
                ],
                "costs": [
                    {
                        "description": "iDEAL",
                        "method": "ideal",
                        "count": 6,
                        "rate": {
                            "fixed": {
                                "currency": "EUR",
                                "value": "0.3500"
                            },
                            "percentage": null
                        },
                        "amountNet": {
                            "currency": "EUR",
                            "value": "2.1000"
                        },
                        "amountVat": {
                            "currency": "EUR",
                            "value": "0.4410"
                        },
                        "amountGross": {
                            "currency": "EUR",
                            "value": "2.5410"
                        }
                    },
                    {
                        "description": "Refunds iDEAL",
                        "method": "refund",
                        "count": 2,
                        "rate": {
                            "fixed": {
                                "currency": "EUR",
                                "value": "0.2500"
                            },
                            "percentage": null
                        },
                        "amountNet": {
                            "currency": "EUR",
                            "value": "0.5000"
                        },
                        "amountVat": {
                            "currency": "EUR",
                            "value": "0.1050"
                        },
                        "amountGross": {
                            "currency": "EUR",
                            "value": "0.6050"
                        }
                    }
                ]
            }
        }
    },
    "_links": {
        "self": {
            "href": "https://api.mollie.com/v2/settlements/next",
            "type": "application/hal+json"
        },
        "payments": {
            "href": "https://api.mollie.com/v2/settlements/stl_jDk30akdN/payments",
            "type": "application/hal+json"
        },
        "refunds": {
            "href": "https://api.mollie.com/v2/settlements/stl_jDk30akdN/refunds",
            "type": "application/hal+json"
        },
        "chargebacks": {
            "href": "https://api.mollie.com/v2/settlements/stl_jDk30akdN/chargebacks",
            "type": "application/hal+json"
        },
        "documentation": {
            "href": "https://docs.mollie.com/reference/v2/settlements-api/get-settlement",
            "type": "text/html"
        }
    }
}