Skip to content

Get a list of payments Beta

Last updated: 14th September 2022

Retrieve a list of payments matching a specified reference to view related payment information, without using a payment ID or session ID.

Use the details below to set up your request.

Endpoints

    get

    https://api.checkout.com/payments


    Query parameters

    You can use the following query parameters to filter and refine your search query:

    ParameterDescription

    reference

    The payment reference to search for. This query parameter is required.

    limit

    The number of results to retrieve. The maximum value is 100. If no value is specified, 10 is used by default.

    skip

    The number of results to skip in the returned list of payments.

    Use this for result pagination. For example, if you perform a query and specify limit=100, a maximum of 100 results will be returned in the initial request. If there are more than 100 matches for the query, you can include skip=100 in a subsequent request to retrieve the next page of results.


    Authentication

    Requests to the endpoint must be authenticated by providing your Access key (OAuth 2.0) or API key in the request's Authorization header.

    1
    --header 'Authorization: Bearer <token>'

    Request example

    1
    2
    curl --location --request GET 'https://api.sandbox.checkout.com/payments?limit=10&skip=0&reference=ORD-5023-4E89' \
    --header 'Authorization: Bearer sk_sbox_wjvrysklsqjmrhn3yoexnshsl72'

    Response example

    The results are sorted by processing date in descending order.

    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
    {
    "limit": 10,
    "skip": 0,
    "total_count": 1,
    "data": [
    {
    "id": "pay_einf5abzzgbejdpuartvqgl36i",
    "requested_on": "2022-04-14T17:03:10.103019Z",
    "source": {
    "type": "card",
    "expiry_month": 11,
    "expiry_year": 2024,
    "scheme": "Visa",
    "last4": "7526",
    "fingerprint": "F2FFA3967396478A7EB64FE6E0A2384F230C23A2F7E520D27EDBB46F24E5B922",
    "bin": "482028",
    "card_type": "CREDIT",
    "card_category": "CONSUMER",
    "issuer": "U.S. BANK, N.A.",
    "issuer_country": "IN",
    "product_id": "N1",
    "product_type": "Visa Rewards"
    },
    "amount": 1000,
    "currency": "EUR",
    "payment_type": "Recurring",
    "reference": "ORD-5023-4E89",
    "description": "Set of 3 masks",
    "status": "Declined",
    "approved": false,
    "3ds": {
    "downgraded": false,
    "enrolled": "N"
    },
    "risk": {
    "flagged": false
    },
    "metadata": {
    "udf1": "TEST123",
    "coupon_code": "NY2018",
    "partner_id": "123989"
    },
    "_links": {
    "self": {
    "href": "https://api.sandbox.checkout.com/payments/pay_einf5abzzgbejdpuartvqgl36i"
    },
    "actions": {
    "href": "https://api.sandbox.checkout.com/payments/pay_einf5abzzgbejdpuartvqgl36i/actions"
    }
    }
    }
    ]
    }