---
title: "Get link session status"
method: GET
path: "/tokenized-payment/v1/link-sessions/link/{linkToken}"
tags: ["Account Linking"]
---

# Get link session status

`GET /tokenized-payment/v1/link-sessions/link/{linkToken}`

Returns the current state of a tokenized payment link session. Poll this endpoint after redirecting the user to determine when the consent flow is complete.

## Path parameters

- `linkToken` string, required

## Response `200`

- GetLinkSessionResponse
  - `linkToken` string, required — Opaque UUID identifying the linking session (the merchant-facing `linkToken`).
  - `status` 'PENDING' | 'CODE_ISSUED' | 'COMPLETED' | 'EXPIRED', required — Current lifecycle state of the link session.
  - `expiresAt` string, required — Overall session TTL (20 min from creation). After this the session transitions to EXPIRED.
  - `authCode` string, nullable, required — Short-lived auth code issued after rider consent. Non-null only when `status = CODE_ISSUED`; pass to `POST /token` to complete the exchange.
  - `authCodeExpiresAt` string, nullable, required — 60-second TTL on `authCode`. Non-null only when `status = CODE_ISSUED`.

## Other responses

- `401` — Missing or invalid merchant JWT.
- `404` — Link session not found or belongs to a different merchant.

---

[API](https://skmtc.net/shopback/apis/online-payments-api.md) · [All operations](https://skmtc.net/shopback/apis/online-payments-api/llms.txt) · [OpenAPI document](https://skmtc-service-staging.skmtc.workers.dev/v1/apis/shopback/online-payments-api/revisions/160fc287769e/schema)