v20

latestOpenAPI 3.0.0raw.githubusercontent.com2026-07-214885191.3 KB

Customers

Get customer session by sessionId

Retrieves a customer session by its sessionId with all data hydrated including customer details and purchases. The session must belong to the authenticated provider.

get/v1/sdk/customers/customer-sessions/{sessionId}

Path parameters

sessionIdstring required

Example:e3f1c2d4b6a89f001122334455667788

Customer session ID/token

Response

Customer session retrieved successfully

createdAtstring required

Session creation date

customerUrlstring required

Full customer URL based on backend configuration (ready to redirect customer)

expiresAtstring required

Session expiration date

sessionIdstring required

Customer session ID/token

status'active' | 'expired' | 'used' required

Session status

updatedAtstring required

Session last update date

Example response

{
  "createdAt": "2025-01-01T11:45:00.000Z",
  "customer": {
    "email": "customer@example.com",
    "externalRef": "auth_user_12345",
    "name": "John Doe",
    "purchases": [
      {
        "amount": 9900,
        "cancellationReason": "Customer request",
        "cancelledAt": "2025-10-28T10:00:00Z",
        "currency": "GBP",
        "endDate": "2025-11-27T10:00:00Z",
        "exchangeRate": 1.32,
        "originalAmount": 7500,
        "planRef": "pln_abc123",
        "productName": "API Gateway Manager",
        "productRef": "prd_abc123",
        "reference": "pur_1A2B3C4D",
        "startDate": "2025-10-27T10:00:00Z",
        "status": "active"
      }
    ],
    "reference": "cus_3c4d5e6f7g8h"
  },
  "customerUrl": "https://solvapay.com/customer/manage?id=e3f1c2d4b6a89f001122334455667788",
  "expiresAt": "2025-01-01T12:00:00.000Z",
  "sessionId": "e3f1c2d4b6a89f001122334455667788",
  "status": "active",
  "updatedAt": "2025-01-01T11:45:00.000Z"
}