v1

latestOpenAPI 3.0.12026-07-24204977.5 KB

Account Linking

Get link session status

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.

get/tokenized-payment/v1/link-sessions/link/{linkToken}

Path parameters

linkTokenstring required

The link session UUID returned by POST /link-sessions/link.

Response

linkTokenstring 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.

expiresAtstring required

Overall session TTL (20 min from creation). After this the session transitions to EXPIRED.

authCodestring 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.

authCodeExpiresAtstring nullable required

60-second TTL on authCode. Non-null only when status = CODE_ISSUED.

Example response

{
  "linkToken": "550e8400-e29b-41d4-a716-446655440000",
  "status": "PENDING",
  "expiresAt": "2026-04-30T10:20:00.000Z",
  "authCode": "a1b2c3d4e5f6a1b2c3d4e5f6a1b2c3d4",
  "authCodeExpiresAt": "2026-04-30T10:01:05.000Z"
}