You are viewing an old version of the API
Get payment

Retrieves details for a specific Payment

Required permissions PAYMENTS_READ

Path Parameters

Name Description
payment_id
string

Required

Unique ID for the desired Payment.

Response Fields

Name Description
errors
Error [ ]

Information on errors encountered during the request.

payment
Payment

The requested Payment.

Examples

You are viewing an old version of the API
GET /v2/payments/{payment_id}
cURL
  • cURL
  • Ruby
  • Python
curl https://connect.squareup.com/v2/payments/{payment_id} \
  -H 'Square-Version: 2019-11-20' \
  -H 'Authorization: Bearer ACCESS_TOKEN'
Response JSON
{
  "payment": {
    "id": "iqrBxAil6rmDtr7cak9g9WO8uaB",
    "created_at": "2019-07-10T13:23:49.154Z",
    "updated_at": "2019-07-10T13:23:49.446Z",
    "amount_money": {
      "amount": 200,
      "currency": "USD"
    },
    "app_fee_money": {
      "amount": 10,
      "currency": "USD"
    },
    "total_money": {
      "amount": 200,
      "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": "nsAyY2"
    },
    "location_id": "XK3DBG77NJBFX",
    "order_id": "qHkNOb03hMgEgoP3gyzFBDY3cg4F",
    "reference_id": "123456",
    "note": "Brief description",
    "customer_id": "VDKXEEKPJN48QDG3BGGFAK05P8",
    "processing_fee": [
      {
        "effective_at": "2019-07-10T15:23:49.000Z",
        "type": "INITIAL",
        "amount_money": {
          "amount": 36,
          "currency": "USD"
        }
      }
    ]
  }
}

Share Feedback

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