Get a customer token

Generate a temporary JWT token for a customer. The token type determines its purpose and permissions.

Token Types

Type	Purpose	Default Expiration	Requirements
`auth`	Customer App session and API calls as the customer	7 days	Customer must have at least one pass
`download`	Wallet pass download link (Apple Wallet / Google Wallet)	Validated against OneTimeLink	Customer must have a generated OneTimeLink

You can customize the expiration with the expires_in parameter.

Building URLs with the Token

Encode the returned accessToken in Base64 to build customer-facing URLs:

Link Type	URL Format
Download	`https://jeri.link/{slug}/download?token={base64Token}`
Session	`https://jeri.link/{slug}/{base64Token}?redirectTo={path}`

Available `redirectTo` paths for session URLs

Path	Section
`profile`	Customer profile
`loyalty/rewards`	Available rewards
`loyalty/earning-flows`	Ways to earn points
`referrals`	Referral program
`coupons`	Customer coupons
`transactions`	Transaction history

Using the auth token as API session

The auth token can be used as a Bearer token to make API calls on behalf of the customer:

Authorization: Bearer {accessToken}

Note: Download URLs are automatically synced to Shopify metafields (jericommerce.download-wallet-pass-url) and Klaviyo profiles (jericommerce_download_wallet_pass_url).

For a step-by-step guide, see Customer Tokens: Wallet Pass Downloads & App Session Links.

Token Types

Building URLs with the Token

Available `redirectTo` paths for session URLs

Using the auth token as API session

Request

Responses

Get a customer token

Token Types#

Building URLs with the Token#

Available redirectTo paths for session URLs#

Using the auth token as API session#

Request

Responses

Token Types

Building URLs with the Token

Available `redirectTo` paths for session URLs

Using the auth token as API session