GET /api/v1/checkout-sessions/:id — Fetch Checkout Session

Poll this endpoint to check whether a subscriber has completed payment for a given checkout session. The response includes the full session state, associated service and payment plan details, the pre-associated user if one was set, and any subscriptions that were created upon payment completion.

GET https://api.retempo.xyz/api/v1/checkout-sessions/:checkoutSessionId

Path Parameters

string

required

The unique identifier of the checkout session to retrieve.

Response

A successful request returns HTTP 200 OK with the full checkout session object.

object

The requested checkout session.

Show checkoutSession fields

string

Unique identifier for the checkout session.

string

ID of the associated service.

string

ID of the associated payment plan.

string | null

ID of the pre-associated user, or null if not set.

string

Current session status — PENDING, PAID, EXPIRED, or CANCELLED.

string | null

Expiry datetime, or null if not set.

string

ISO 8601 datetime the session was created.

object

Nested service object with id, name, and status.

object

Nested payment plan with id, name, amount, and currency.

object | null

Nested user object if a userId was associated, otherwise null.

array

List of subscriptions created when payment was completed. Empty while the session is still PENDING.

200 — Checkout session retrieved

{
  "checkoutSession": {
    "id": "clz1checkout789",
    "serviceId": "clz1abc2def3ghi4",
    "paymentPlanId": "clz1plan567",
    "userId": null,
    "status": "PENDING",
    "expiresAt": "2025-06-02T10:00:00.000Z",
    "createdAt": "2025-06-01T10:10:00.000Z",
    "service": {
      "id": "clz1abc2def3ghi4",
      "name": "DataStream Pro",
      "status": "ACTIVE"
    },
    "paymentPlan": {
      "id": "clz1plan567",
      "name": "Pro Monthly",
      "amount": "49.000000",
      "currency": "USDC"
    },
    "user": null,
    "subscriptions": []
  }
}

Example Request

curl https://api.retempo.xyz/api/v1/checkout-sessions/clz1checkout789

Error Codes

Status	Message	Condition
`404 Not Found`	`Checkout session was not found.`	No session exists for the provided ID.

Check the subscriptions array in the response — a non-empty list means payment was completed and a subscription is active.

Overview

Services

Payment Plans

Checkout & Invoicing

Settlements

GET /api/v1/checkout-sessions/:id — Fetch Checkout Session

Path Parameters

Response

200 — Checkout session retrieved

Example Request

Error Codes

​Path Parameters

​Response

​200 — Checkout session retrieved

​Example Request

​Error Codes

Path Parameters

Response

200 — Checkout session retrieved

Example Request

Error Codes