Skip to main content
GET
https://api.stateset.com
/
v1
/
payments
/
:id
curl --location 'https://api.stateset.com/v1/payments/pay_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "pay_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "payment",
  "amount": 15000,
  "currency": "USD",
  "status": "succeeded",
  "captured": true,
  "created_at": "2024-01-19T15:30:00Z",
  "updated_at": "2024-01-19T15:30:05Z",
  "payment_method": {
    "type": "card",
    "card": {
      "last4": "4242",
      "brand": "visa",
      "exp_month": 12,
      "exp_year": 2025,
      "fingerprint": "Xt5EWLLDS7FJjR1c",
      "country": "US",
      "funding": "credit"
    }
  },
  "order_id": "order_123456",
  "invoice_id": null,
  "customer_id": "cust_abc123",
  "customer": {
    "id": "cust_abc123",
    "email": "[email protected]",
    "name": "John Doe"
  },
  "description": "Payment for Order #123456",
  "statement_descriptor": "STATESET ORDER",
  "receipt_url": "https://receipts.stateset.com/pay_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "receipt_number": "2234-5678",
  "billing_address": {
    "line1": "123 Main St",
    "city": "Los Angeles",
    "state": "CA",
    "postal_code": "90001",
    "country": "US"
  },
  "processor_response": {
    "approved": true,
    "authorization_code": "123456",
    "avs_result": "Y",
    "cvv_result": "M",
    "network_transaction_id": "123456789",
    "processor": "stripe",
    "risk_score": 32
  },
  "refunds": {
    "total_refunded": 0,
    "has_more": false,
    "data": []
  },
  "metadata": {
    "order_reference": "ORD-2024-001",
    "channel": "web"
  }
}
This endpoint retrieves detailed information about a specific payment including transaction details and processing status.

​
Authentication

This endpoint requires a valid API key with payments:read permissions. 
Authorization: Bearer YOUR_API_KEY

​
Path Parameters

​
id
string
required
The unique identifier of the payment

​
Query Parameters

​
expand
array
Expand related objects. Options: “customer”, “order”, “invoice”, “refunds”, “disputes”

​
Response

​
id
string
Unique payment identifier
​
object
string
Object type, always “payment”
​
amount
integer
Payment amount in cents
​
currency
string
ISO 4217 currency code
​
status
string
Payment status: “pending”, “processing”, “succeeded”, “failed”, “cancelled”
​
payment_method
object
Payment method details
​
processor_response
object
Response from payment processor
curl --location 'https://api.stateset.com/v1/payments/pay_0901f083-aa1c-43c5-af5c-0a9d2fc64e30' \
--header 'Authorization: Bearer YOUR_API_KEY'

{
  "id": "pay_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "object": "payment",
  "amount": 15000,
  "currency": "USD",
  "status": "succeeded",
  "captured": true,
  "created_at": "2024-01-19T15:30:00Z",
  "updated_at": "2024-01-19T15:30:05Z",
  "payment_method": {
    "type": "card",
    "card": {
      "last4": "4242",
      "brand": "visa",
      "exp_month": 12,
      "exp_year": 2025,
      "fingerprint": "Xt5EWLLDS7FJjR1c",
      "country": "US",
      "funding": "credit"
    }
  },
  "order_id": "order_123456",
  "invoice_id": null,
  "customer_id": "cust_abc123",
  "customer": {
    "id": "cust_abc123",
    "email": "[email protected]",
    "name": "John Doe"
  },
  "description": "Payment for Order #123456",
  "statement_descriptor": "STATESET ORDER",
  "receipt_url": "https://receipts.stateset.com/pay_0901f083-aa1c-43c5-af5c-0a9d2fc64e30",
  "receipt_number": "2234-5678",
  "billing_address": {
    "line1": "123 Main St",
    "city": "Los Angeles",
    "state": "CA",
    "postal_code": "90001",
    "country": "US"
  },
  "processor_response": {
    "approved": true,
    "authorization_code": "123456",
    "avs_result": "Y",
    "cvv_result": "M",
    "network_transaction_id": "123456789",
    "processor": "stripe",
    "risk_score": 32
  },
  "refunds": {
    "total_refunded": 0,
    "has_more": false,
    "data": []
  },
  "metadata": {
    "order_reference": "ORD-2024-001",
    "channel": "web"
  }
}