Common Token Claims

The following are claims in common, used within the KYA (Know Your Agent), PAY (Payment), and KYA-PAY (combined Know Your Agent and Payment) Tokens.

Header

ClaimDescription
alg (algorithm)Cryptographic algorithm to sign the token
kid (key ID)JWT key ID
typ (type)Type of the token - MUST be kya+jwt, pay+jwt, or kya-pay+jwt

Payload

ClaimDescription
env (environment)Issuer environment - production or sandbox
btg (buyer tag)OPTIONAL - An opaque reference ID internal to the buyer.
ssi (seller service ID)OPTIONAL - Seller Service ID that this token was created for.
sdm (seller domain)OPTIONAL - Seller domain, associated with the audience claim, the token is intended for.
ori (originator)OPTIONAL - URL of the token's originator.
iat (issued at)Identifies the time at which the JWT was issued. This claim must have a value in the past and can be used to determine the age of the JWT.
iss (issuer)URL of the token's issuer. Used for discovering JWK Sets for token signature verification, via the /.well-known/jwks.json suffix mechanism.
jti (JWT ID)Provides a unique identifier (UUID) for the JWT. The value may be used for rate limiting. Note a token may be used multiple times by the agent until it expires.
aud(audience)Audience (used for audience binding and replay attack mitigation), uniquely identifying the seller agent. A single string value.
sub (subject)Subject Identifier. Must be pairwise unique within a given issuer.
exp (expiration time)Identifies the expiration time on or after which the JWT MUST NOT be accepted for processing.

Additional claims MAY be defined and used in these tokens. The recipient MUST ignore any unrecognized claims.