Verify access credentials | TTG Developer Portal

Checks the customer’s credentials against the named access scheme and the event on the referenced cart. On success the response carries a short-lived grant id the caller spends to apply the free companion ticket. On failure the response is a structured error carrying a code the caller keys off to render the right copy: the customer can correct their details, the card belongs to a different scheme, the event is not enrolled in the flow, or the upstream verifier is unavailable.

Checks the customer's credentials against the named access scheme and the event on the referenced cart. On success the response carries a short-lived grant id the caller spends to apply the free companion ticket. On failure the response is a structured error carrying a code the caller keys off to render the right copy: the customer can correct their details, the card belongs to a different scheme, the event is not enrolled in the flow, or the upstream verifier is unavailable.

Authentication

X-TT-API-Keystring

API Key authentication via header

Request

This endpoint expects an object.

accessTypeenumRequired

The access scheme to verify against.

credentialsobjectRequired

Scheme-specific credentials. Which fields are required depends on accessType.

referenceobjectRequired

The resource the verification applies to and the issued grant is spendable against.

Response

Credentials verified; grant issued.

grantIdstringOptional

Opaque, single-use credential for the grant issued by this verification. Pass it unchanged when patching the cart to apply the free companion.

expiresAtdatetimeOptional

When the grant expires and can no longer be spent.

Authentication

Headers

Request

Response