Create Token

One of kya, pay, or kya-pay. The created token will contain JWT header typ set to <type>+jwt. Onboarded sellers only accept the token types listed on their service.

Buyer’s internal identifier for the token. e.g. "research-agent-xyz". Max 128 characters.

Amount of funds, in USD, allocated to the token. This is the maximum the seller can charge. Required for pay and kya-pay; must be omitted for kya. Plain decimal string: no sign, no exponent. Onboarded sellers accept up to six decimal places and enforce their own minimum. External sellers accept at most two decimal places. Must be greater than zero and no more than the wallet balance.

ID of an onboarded seller service. Use this or sellerDomainOrUrl, never both. The service must be active and approved, and must accept the requested token type.

Domain name or full URL of an external seller, with or without a scheme. Use this or sellerServiceId, never both. Requires an Organization Buyer API key.

Unix time in seconds at which the token expires. Provide an absolute epoch time, not a duration. Omit to get the maximum lifetime:

• 24 hours for an onboarded seller
• 5 minutes for an external seller, or a shorter per-seller maximum where configured.

A supplied value is clamped into the allowed window rather than rejected: anything earlier than 10 seconds from now becomes 10 seconds from now, anything later than the maximum becomes the maximum.

ID of the agent wallet that funds the token. Defaults to the agent's active wallet on the default stablecoin network. Required, and must be an active Visa or Mastercard wallet, when additionalInfo is provided.

The signed JWT for the token.