You are viewing an old version of the API
List payments

Retrieves a list of payments taken by the account making the request

Max results per page: 100

Required permissions PAYMENTS_READ

Query Parameters

Name Description
begin_time
string

Timestamp for the beginning of the reporting period, in RFC 3339 format. Inclusive. Default: The current time minus one year.

end_time
string

Timestamp for the end of the requested reporting period, in RFC 3339 format.

Default: The current time.

sort_order
string

The order in which results are listed.

  • ASC - oldest to newest
  • DESC - newest to oldest (default).
cursor
string

A pagination cursor returned by a previous call to this endpoint. Provide this to retrieve the next set of results for the original query.

See Pagination for more information.

location_id
string

ID of location associated with payment

total
integer

The exact amount in the total_money for a Payment.

last_4
string

The last 4 digits of Payment card.

card_brand
string

The brand of Payment card. For example, VISA

Response Fields

Name Description
cursor
string

The pagination cursor to be used in a subsequent request. If empty, this is the final response.

See Pagination for more information.

errors
Error [ ]

Information on errors encountered during the request.

payments
Payment [ ]

The requested list of Payments.

Examples

You are viewing an old version of the API
GET /v2/payments
cURL
  • cURL
  • Ruby
  • Python
curl https://connect.squareup.com/v2/payments \
  -H 'Square-Version: 2019-11-20' \
  -H 'Authorization: Bearer ACCESS_TOKEN'
Response JSON
{
  "payments": [
    {
      "id": "6SRrImjQGn8FuzIsURiN677CwaB",
      "created_at": "2019-07-09T14:36:13.745Z",
      "updated_at": "2019-07-09T14:36:13.883Z",
      "amount_money": {
        "amount": 1000,
        "currency": "USD"
      },
      "total_money": {
        "amount": 1000,
        "currency": "USD"
      },
      "status": "APPROVED",
      "source_type": "CARD",
      "card_details": {
        "status": "AUTHORIZED",
        "card": {
          "card_brand": "VISA",
          "last_4": "1111",
          "exp_month": 2,
          "exp_year": 2022,
          "fingerprint": "sq-1-lHpUJIUyqOPQmH89b6GuQEljmc-mZmu4kSTaMlkLDkJI7NVjAl4Zirn2sk3OeyVKVA"
        },
        "entry_method": "KEYED",
        "cvv_status": "CVV_ACCEPTED",
        "avs_status": "AVS_ACCEPTED",
        "auth_result_code": "NQbV3A"
      },
      "location_id": "XK3DBG77NJBFX",
      "order_id": "EM6qWxDd7RSy5udzjXktPw3PJa4F"
    },
    {
      "id": "MRWmTKxBDNRgwfNSZptAO76xuaB",
      "created_at": "2019-07-08T01:00:51.607Z",
      "updated_at": "2019-07-08T01:13:58.508Z",
      "amount_money": {
        "amount": 1000,
        "currency": "USD"
      },
      "total_money": {
        "amount": 1000,
        "currency": "USD"
      },
      "status": "COMPLETED",
      "source_type": "CARD",
      "card_details": {
        "status": "CAPTURED",
        "card": {
          "card_brand": "VISA",
          "last_4": "2796",
          "exp_month": 7,
          "exp_year": 2026,
          "fingerprint": "sq-1-TpmjbNBMFdibiIjpQI5LiRgNUBC7u1689i0TgHjnlyHEWYB7tnn-K4QbW4ttvtaqXw"
        },
        "entry_method": "ON_FILE",
        "cvv_status": "CVV_ACCEPTED",
        "avs_status": "AVS_ACCEPTED",
        "auth_result_code": "vPIr0K"
      },
      "location_id": "XK3DBG77NJBFX",
      "order_id": "OVE4bJyb4B6bGFwMYEtVdfE4ge4F",
      "customer_id": "VDKXEEKPJN48QDG3BGGFAK05P8",
      "processing_fee": [
        {
          "effective_at": "2019-07-08T03:00:53.000Z",
          "type": "INITIAL",
          "amount_money": {
            "amount": 59,
            "currency": "USD"
          }
        }
      ]
    }
  ],
  "cursor": "Q2g4SUF4SWJUVkpYYlZSTGVFSkVUbEpuZDJaT1UxcHdkRUZQTnpaNGRXRkNFSmVJNVBpOExRPT0"
}

Share Feedback

Thanks for visiting the Square API documentation. What's on your mind?