List customer payments

get https://api.mollie.com/v2/customers/{customerId}/payments

Retrieve all payments linked to the customer.

🔑
Access with
API key
Access token with payments.read

Path Params

customerId

string

required

Provide the ID of the related customer.

Query Params

profileId

string | null

The identifier referring to the profile this entity belongs to.

Most API credentials are linked to a single profile. In these cases the profileId can be omitted in the creation request. For organization-level credentials such as OAuth access tokens however, the profileId parameter is required.

testmode

boolean | null

Defaults to false

Most API credentials are specifically created for either live mode or test mode. In those cases the testmode query parameter can be omitted. For organization-level credentials such as OAuth access tokens, you can enable test mode by setting the testmode query parameter to true.

Test entities cannot be retrieved when the endpoint is set to live mode, and vice versa.

Responses

Response body

object

count

integer

1 to 250

The number of items in this result set. If more items are available, a _links.next URL will be present in the result as well.

The maximum number of items per result set is controlled by the limit property provided in the request. The default limit is 50 items.

_embedded

object

payments

array of objects

An array of payment objects. For a complete reference of the payment object, refer to the Get payment endpoint documentation.

payments

object

_links

object

Links to help navigate through the lists of items. Every URL object will contain an href and a type field.

self

object

The URL to the current set of items.

object | null

The previous set of items, if available.

object | null

The next set of items, if available.

documentation

object

In v2 endpoints, URLs are commonly represented as objects with an href and type field.

Language

Credentials

Request


xxxxxxxxxx
1
curl -X GET https://api.mollie.com/v2/customers/cst_8wmqcHMN4U/payments \
2
    -H "Authorization: Bearer live_dHar4XY7LxsDOtmnkVtjNVWXLSlXsM"


xxxxxxxxxx
60
}
1
{
2
  "count": 5,
3
  "_embedded": {
4
    "payments": [
5
      {
6
        "resource": "payment",
7
        "id": "tr_5B8cwPMGnU6qLbRvo7qEZo",
8
        "mode": "live",
9
        "createdAt": "2024-02-12T11:58:35.0Z",
10
        "expiresAt": "2024-02-12T12:13:35.0Z",
11
        "status": "open",
12
        "isCancelable": false,
13
        "amount": {
14
          "value": "75.00",
15
          "currency": "GBP"
16
        },
17
        "description": "Order #12345",
18
        "method": "ideal",
19
        "metadata": null,
20
        "details": null,
21
        "customerId": "cst_8wmqcHMN4U",
22
        "profileId": "pfl_QkEhN94Ba",
23
        "redirectUrl": "https://webshop.example.org/order/12345/",
24
        "_links": {
25
          "checkout": {

200A list of payment objects. For a complete reference of the payment object, refer to the Get payment endpoint documentation.

404No entity with this ID exists.